Auf dieser Seite werden die Datenbank-Flags beschrieben, mit denen AlloyDB Omni Funktionen speziell für die spaltenbasierte Engine aktiviert und verwaltet. Eine Liste aller Datenbank-Flags, die von AlloyDB Omni unterstützt werden, finden Sie unter Unterstützte Datenbank-Flags.
Flags, die mit Instanzneustarts gekennzeichnet sind, bedeuten, dass Sie eine AlloyDB Omni-Instanz neu starten müssen, wenn Sie dieses Flag für diese Instanz festlegen, entfernen oder ändern. Der Flag-Wert 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 spaltenbasierte Engine von AlloyDB Omni aktiviert.
Automatische Spaltenformatierung
google_columnar_engine.enable_auto_columnarization
| Typ | Boolean |
| Standard | on |
| Instanzneustarts | Nein |
Wenn on, werden die Funktionen zur automatischen 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 dem Spaltenspeicher Ihres Clusters hinzufügen soll, unabhängig vom automatischen Spaltenformatierungsprozess. 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. Das Format ist:
'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 Spaltenformatierung auf der 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
DAYSoderHOURS.
Wenn nicht definiert, führt AlloyDB Omni den Prozess der automatischen Spaltenformatierung 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 entspricht |
| Standard | 1 GB Instanzspeicher |
| 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 Arbeitsspeichers der Instanz 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 auf off gesetzt ist, während google_columnar_engine.enabled auf on gesetzt ist, bleibt die spaltenorientierte Engine aktiviert und behält ihren Spaltenspeicher bei. AlloyDB Omni verwendet jedoch keine spaltenorientierten Daten, wenn Abfragen verarbeitet werden.
google_columnar_engine.omni_storage_cache_directory
Mit diesem Flag können Sie einen separaten dedizierten Verzeichnispfad für Datenträger-Cache-Dateien für die spaltenorientierte Engine angeben.
| Typ | String |
| Zulässige Werte | Ein einzelner Verzeichnispfad, in dem Dateien des Datenträger-Cache gespeichert werden. |
| Standard | Die Gesamtgröße des dedizierten PersistentVolumeClaim (PVC) wird für den spaltenorientierten 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 den Datenträger-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 Datenträger-Cache der spaltenbasierten 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 Datenträger-Cache. Das Limit von 1.000 * google_columnar_engine.memory_size_in_mb gilt ebenfalls.
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 spaltenbasierten Einheit – einer Gruppe von Datenblöcken in einer spaltenbasierten Tabelle –, wenn die folgenden Bedingungen erfüllt sind:
Die Tabelle der spaltenbasierten Einheit hat den Scan-Schwellenwert überschritten, der durch das separate Flag
refresh_threshold_scan_countdefiniert ist.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 ungültig, weil sich die zeilenbasierten Daten ändern, auf denen die spaltenbasierte Tabelle basiert.
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 Flags refresh_threshold_scan_count gibt den Mindestwert dieses Zählers in einer beliebigen spaltenorientierten Tabelle an, bevor AlloyDB Omni die Daten aktualisieren kann. Anschließend verwendet AlloyDB Omni den durch 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 spaltenbasierte Daten aktualisiert werden sollen, und verwendet stattdessen nur refresh_threshold_percentage.
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 adaptiven automatischen Aktualisierungsprozess auf der 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
DAYSoderHOURS.
Wenn nicht definiert, führt AlloyDB Omni den adaptiven automatischen Aktualisierungsprozess einmal pro Stunde aus.
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 spaltenbasierten Einheit, die ungültig geworden sind, überschreitet den Wert des Flags min_adaptive_auto_refresh_blocks. Spaltenbasierte Datenblöcke werden aufgrund von Änderungen an den zeilenbasierten Daten, auf die sich die spaltenbasierte Tabelle bezieht, ungültig.
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 |
| Startet die Instanz neu | No |
Definiert die maximale Anzahl paralleler Threads, die für den vektorisierten Join-Operator verfügbar sind, der durch das Flag enable_vectorized_join aktiviert wird.
Sie können einen Wert definieren, der bis zur Hälfte der vCPUs der Instanz reicht. Bei einer Instanz mit 16 vCPUs ist der maximale Wert dieses Flags beispielsweise 8.
Funktionen in der Vorabversion
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 |
| Startet die Instanz neu | No |
Wenn sowohl dieses Flag als auch enable_json_support auf on gesetzt sind, lässt AlloyDB Omni PostgreSQL-JSON- und JSONB-Datentypen im Spaltenspeicher zu.