Auf dieser Seite werden die Datenbank-Flags beschrieben, mit denen in AlloyDB Omni Funktionen speziell für die spaltenorientierte Engine aktiviert und verwaltet werden. Eine Liste aller Datenbank-Flags, die von AlloyDB Omni unterstützt werden, finden Sie unter Unterstützte Datenbank-Flags.
Bei Flags, die mit Instance restarts (Instanzneustarts) gekennzeichnet sind, müssen Sie eine AlloyDB Omni-Instanz neu starten, wenn Sie dieses Flag für diese Instanz festlegen, entfernen oder ändern. Der Wert des Flags wird für die Instanz beibehalten, bis Sie ihn wieder ändern.
Eine Anleitung zum Festlegen eines Datenbank-Flags finden Sie unter AlloyDB Omni-Datenbank-Flags konfigurieren.
Aktivierung
google_columnar_engine.enabled
Typ | Boolean |
Standard | off |
Instanzneustarts | Ja |
Wenn on
, wird die spaltenorientierte Engine von AlloyDB Omni aktiviert.
Automatische Spaltenformatierung
google_columnar_engine.enable_auto_columnarization
Typ | Boolean |
Standard | on |
Instanzneustarts | Nein |
Wenn on
, werden die Funktionen für die automatische Spaltenformatierung der spaltenbasierten Engine aktiviert.
google_columnar_engine.relations
Typ | String |
Standard | Leerer String |
Instanzneustarts | Nein |
Gibt eine Liste von Spalten an, die AlloyDB Omni zusätzlich zum automatischen Prozess der Spaltenorientierung dem Spaltenspeicher Ihres Clusters hinzufügen soll. Diese Spalten können aus beliebigen Tabellen in Ihrem Cluster stammen.
Der Wert des Flags ist als durch Kommas getrennte Liste von Elementen formatiert. Jedes Element gibt eine oder mehrere Spalten aus einer einzelnen Tabelle an, die in diesem Format ausgedrückt werden:
'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'
Weitere Informationen finden Sie unter Spaltenspeicherinhalte manuell verwalten.
google_columnar_engine.auto_columnarization_schedule
Typ | String |
Standard | Leerer String |
Instanzneustarts | Nein |
Zulässiger Höchstwert | 2147483647 |
Gibt an, wie oft AlloyDB Omni den Prozess der automatischen Spaltenorientierung für die Instanz ausführt.
Der Wert ist ein String im folgenden Format:
'EVERY NUMBER TIME_UNITS'
Ersetzen Sie Folgendes:
NUMBER: Eine positive Ganzzahl.
TIME_UNITS: entweder
DAYS
oderHOURS
.
Wenn nicht definiert, führt AlloyDB Omni den Prozess der automatischen Spaltenorientierung einmal pro Stunde aus.
Größenanpassung und Abfrageverarbeitung
google_columnar_engine.memory_size_in_mb
Typ | Integer |
Zulässige Werte | Zwischen 128 und dem Wert, der 70% des Instanzspeichers darstellt |
Standard | 1 GB Instanzarbeitsspeicher |
Instanzneustarts | Ja |
Die Menge an Instanzarbeitsspeicher in Mebibyte (MiB), die AlloyDB Omni dem Spaltenspeicher zuweist.
Wenn dieses Flag nicht festgelegt ist, weist AlloyDB Omni dem Spaltenspeicher 1 GB des Instanzarbeitsspeichers zu.
google_columnar_engine.enable_columnar_scan
Typ | Boolean |
Standard | on |
Instanzneustarts | Nein |
Wenn on
, kann AlloyDB Omni beim Verarbeiten von Abfragen auf Daten im Spaltenspeicher zugreifen.
Wenn dieses Flag off
ist, während google_columnar_engine.enabled
on
ist, bleibt die spaltenorientierte Engine aktiviert und behält ihren Spaltenspeicher bei. AlloyDB Omni verwendet jedoch keine spaltenorientierten Daten, wenn Anfragen verarbeitet werden.
google_columnar_engine.omni_storage_cache_directory
Mit diesem Flag können Sie einen separaten dedizierten Verzeichnispfad für die Dateien des Festplatten-Cache für die spaltenorientierte Engine angeben.
Typ | String |
Zulässige Werte | Ein einzelner Verzeichnispfad, in dem Dateien des Festplatten-Cache gespeichert werden. |
Standard | Die Gesamtgröße des dedizierten PersistentVolumeClaim (PVC) wird für den spaltenweisen Spill-to-Disk-Cache zugewiesen. |
Instanzneustarts | Ja |
google_columnar_engine.storage_cache_size
Wenn google_columnar_engine.omni_storage_cache_directory
nicht angegeben ist, müssen Sie Festplatten-Cache aktivieren, um die Größe des Speichercaches zu aktivieren.
Typ | Integer |
Zulässige Werte | 1024 ... 2147483647 |
Standard | Wenn google_columnar_engine.omni_storage_cache_directory nicht angegeben ist, werden 5% des Festplatten-Cache der Spalten-Engine zugewiesen. |
Instanzneustarts | Ja |
Wenn on
, kann AlloyDB Omni die Größe des Speichercaches für die spaltenbasierte Engine konfigurieren.
Wenn google_columnar_engine.omni_storage_cache_directory
nicht angegeben ist, beträgt der maximal zulässige Wert für dieses Flag 50% des gesamten Festplatten-Cache. Außerdem gilt die Obergrenze von 1.000 × google_columnar_engine.memory_size_in_mb
.
Wartungsaktivitäten
google_job_scheduler.maintenance_cpu_percentage
Typ | Integer |
Zulässige Werte | 0 ... 100 |
Standard | 20 |
Instanzneustarts | Nein |
Der maximale Prozentsatz der CPU-Kapazität einer Instanz, den die spaltenbasierte Engine für die Hintergrundverarbeitung verwenden kann.
google_job_scheduler.max_parallel_workers_per_job
Typ | Integer |
Zulässige Werte | 0 ... 262143 |
Standard | 2 |
Instanzneustarts | Nein |
Die maximale Anzahl paralleler Worker, die die spaltenbasierte Engine zum Bearbeiten eines einzelnen Hintergrundverarbeitungsvorgangs erstellen kann.
Automatische Aktualisierung – ereignisbasiert
google_columnar_engine.refresh_threshold_percentage
Typ | Integer |
Zulässige Werte | 1 ... 100 |
Standard | 50 |
Instanzneustarts | Nein |
Gibt den Grenzwert für die Datenaktualisierung des Spaltenspeichers als Prozentsatz an.
AlloyDB Omni aktualisiert die Daten in einer Spalteneinheit – einer Gruppe von Datenblöcken in einer Spaltentabelle –, wenn die folgenden Bedingungen erfüllt sind:
Die Tabelle der Spalteneinheit hat den durch das separate Flag
refresh_threshold_scan_count
definierten Scan-Schwellenwert überschritten.Der Prozentsatz der zugrunde liegenden Datenblöcke der spaltenweisen Einheit, die ungültig geworden sind, überschreitet den Wert des
refresh_threshold_percentage
-Flags. Spaltenbasierte Datenblöcke werden aufgrund von Änderungen an den zeilenbasierten Daten, auf denen die spaltenbasierte Tabelle basiert, ungültig.
google_columnar_engine.refresh_threshold_scan_count
Typ | Integer |
Zulässige Werte | 0 ... 2147483647 |
Standard | 5 |
Instanzneustarts | Nein |
AlloyDB Omni zählt die Tabellenscans fortlaufend, die für jede spaltenbasierte Tabelle seit der letzten DML-Abfrage der jeweiligen Tabelle ausgeführt wurden. Der Wert des refresh_threshold_scan_count
-Flags gibt den Mindestwert dieses Zählers in einer beliebigen tabellarischen Tabelle an, bevor AlloyDB Omni die Daten aktualisieren kann. AlloyDB Omni verwendet dann den von refresh_threshold_percentage
definierten Schwellenwert für ungültige Blöcke, um zu bestimmen, wann die Daten der Tabelle aktualisiert werden sollen.
Wenn der Wert dieses Flags auf 0
gesetzt ist, ignoriert AlloyDB Omni Tabellenscans, um zu bestimmen, wann Spaltendaten aktualisiert werden sollen. Stattdessen wird nur refresh_threshold_percentage
verwendet.
Automatische Aktualisierung – regelmäßig und adaptiv
google_columnar_engine.adaptive_auto_refresh_schedule
Typ | String |
Standard | Leerer String |
Instanzneustarts | Nein |
Zulässiger Höchstwert | 2147483647 |
Gibt an, wie oft AlloyDB Omni den Prozess für die adaptive automatische Aktualisierung für die Instanz ausführt.
Der Wert ist ein String im folgenden Format:
'EVERY NUMBER TIME_UNITS'
Ersetzen Sie Folgendes:
NUMBER: eine positive Ganzzahl.
TIME_UNITS: entweder
DAYS
oderHOURS
.
Wenn nicht definiert, wird der Prozess „Adaptive Auto Refresh“ in AlloyDB Omni einmal pro Stunde ausgeführt.
google_columnar_engine. min_adaptive_auto_refresh_blocks
Typ | Integer |
Zulässige Werte | 0 ... 2147483647 |
Standard | 50 |
Instanzneustarts | Nein |
Die Anzahl der zugrunde liegenden Datenblöcke der spaltenweisen Einheit, die ungültig geworden sind, überschreitet den Wert des min_adaptive_auto_refresh_blocks
-Flags. Spaltenbasierte Datenblöcke werden ungültig, weil sich die zeilenbasierten Daten ändern, auf denen die spaltenbasierte Tabelle basiert.
Vektorisierter Join
google_columnar_engine.enable_vectorized_join
Typ | Boolean |
Standard | off |
Instanz wird neu gestartet | No |
Wenn on
, verwendet AlloyDB Omni automatisch multithreaded vektorisierte Vorgänge, um die Leistung von Abfragen zu verbessern, die mehrere Tabellen verknüpfen.
Weitere Informationen finden Sie unter Vektorisierte Joins aktivieren.
google_columnar_engine.vectorized_join_threads
Typ | Integer |
Zulässige Werte | Bis zur Hälfte der vCPU-Anzahl der Instanz |
Standard | 1 |
Instanz wird neu gestartet | No |
Definiert die maximale Anzahl paralleler Threads, die für den vektorisierten Join-Operator verfügbar sind. Dieser wird durch das Flag enable_vectorized_join
aktiviert.
Sie können einen Wert definieren, der bis zur Hälfte der vCPUs der Instanz beträgt. Bei einer Instanz mit 16 vCPUs ist der maximale Wert dieses Flags beispielsweise 8
.
Vorschaufeatures
google_columnar_engine.enable_json_support
Typ | Boolean |
Standard | off |
Instanz wird neu gestartet | No |
Wenn sowohl dieses Flag als auch enable_raw_format
auf on
gesetzt sind, sind in AlloyDB Omni PostgreSQL-Datentypen JSON und JSONB im Spaltenspeicher zulässig.
google_columnar_engine.enable_raw_format
Typ | Boolean |
Standard | off |
Instanz wird neu gestartet | No |
Wenn sowohl dieses Flag als auch enable_json_support
auf on
gesetzt sind, erlaubt AlloyDB Omni PostgreSQL-Datentypen JSON und JSONB im Spaltenspeicher.