Flags für die spaltenbasierte Engine

Wählen Sie eine Dokumentationsversion aus:

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

TypBoolean
Standardoff
InstanzneustartsJa

Wenn on, wird die spaltenorientierte Engine von AlloyDB Omni aktiviert.

Automatische Spaltenformatierung

google_columnar_engine.enable_auto_columnarization

TypBoolean
Standardon
InstanzneustartsNein

Wenn on, werden die Funktionen für die automatische Spaltenformatierung der spaltenbasierten Engine aktiviert.

google_columnar_engine.relations

TypString
StandardLeerer String
InstanzneustartsNein

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

TypString
StandardLeerer String
InstanzneustartsNein
Zulässiger Höchstwert2147483647

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 oder HOURS.

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

TypInteger
Zulässige WerteZwischen 128 und dem Wert, der 70% des Instanzspeichers darstellt
Standard1 GB Instanzarbeitsspeicher
InstanzneustartsJa

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

TypBoolean
Standardon
InstanzneustartsNein

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.

TypString
Zulässige WerteEin einzelner Verzeichnispfad, in dem Dateien des Festplatten-Cache gespeichert werden.
StandardDie Gesamtgröße des dedizierten PersistentVolumeClaim (PVC) wird für den spaltenweisen Spill-to-Disk-Cache zugewiesen.
InstanzneustartsJa

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.

TypInteger
Zulässige Werte1024 ... 2147483647
StandardWenn google_columnar_engine.omni_storage_cache_directory nicht angegeben ist, werden 5% des Festplatten-Cache der Spalten-Engine zugewiesen.
InstanzneustartsJa

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

TypInteger
Zulässige Werte0 ... 100
Standard20
InstanzneustartsNein

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

TypInteger
Zulässige Werte0 ... 262143
Standard2
InstanzneustartsNein

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

TypInteger
Zulässige Werte1 ... 100
Standard50
InstanzneustartsNein

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 Scan-Schwellenwert überschritten, der durch das separate Flag refresh_threshold_scan_count definiert wird.

  • 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

TypInteger
Zulässige Werte0 ... 2147483647
Standard5
InstanzneustartsNein

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 Spalte 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

TypString
StandardLeerer String
InstanzneustartsNein
Zulässiger Höchstwert2147483647

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 oder HOURS.

Wenn nicht definiert, wird der Prozess für die adaptive automatische Aktualisierung in AlloyDB Omni einmal pro Stunde ausgeführt.

google_columnar_engine. min_adaptive_auto_refresh_blocks

TypInteger
Zulässige Werte0 ... 2147483647
Standard50
InstanzneustartsNein

Die Anzahl der zugrunde liegenden Datenblöcke der spaltenförmigen 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

TypBoolean
Standardoff
Instanz wird neu gestartetNo

Wenn on, verwendet AlloyDB Omni automatisch multithreaded vektorisierte Vorgänge, um die Leistung von Abfragen zu verbessern, bei denen mehrere Tabellen verknüpft werden.

Weitere Informationen finden Sie unter Vektorisierte Joins aktivieren.

google_columnar_engine.vectorized_join_threads

TypInteger
Zulässige WerteBis zur Hälfte der vCPU-Anzahl der Instanz
Standard1
Instanz wird neu gestartetNo

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

TypBoolean
Standardoff
Instanz wird neu gestartetNo

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

TypBoolean
Standardoff
Instanz wird neu gestartetNo

Wenn sowohl dieses Flag als auch enable_json_support auf on gesetzt sind, erlaubt AlloyDB Omni PostgreSQL-Datentypen JSON und JSONB im Spaltenspeicher.