本頁面說明 AlloyDB Omni 用來啟用及管理直欄引擎專屬功能的資料庫標記。如要查看 AlloyDB Omni 支援的所有資料庫旗標，請參閱「支援的資料庫旗標」。
標有「執行個體重新啟動」的旗標表示，您必須在 AlloyDB Omni 執行個體上設定、移除或修改這類旗標時，重新啟動該執行個體。除非再次修改，否則系統會保留執行個體的旗標值。
如需如何設定資料庫旗標的說明，請參閱「設定 AlloyDB Omni 資料庫旗標」。
啟用作業
google_columnar_engine.enabled
| 類型 | Boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
如果 on，則啟用 AlloyDB Omni 資料欄引擎。
自動分欄
google_columnar_engine.enable_auto_columnarization
| 類型 | Boolean |
| 預設 | on |
| 執行個體重新啟動 | 否 |
如果為 on，則啟用資料欄引擎的自動分欄功能。
google_columnar_engine.relations
| 類型 | String |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
指定要新增至叢集資料欄儲存區的資料欄清單 (自動欄狀化程序除外)。這些資料欄可來自叢集內的任何資料表。
這個標記的值格式為以逗號分隔的項目清單。每個項目會指定單一資料表的一或多個資料欄，格式如下：
'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'
詳情請參閱「手動管理資料欄存放區內容」。
google_columnar_engine.auto_columnarization_schedule
| 類型 | String |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
| 允許的最大值 | 2147483647 |
指定 AlloyDB Omni 在執行個體上執行自動資料欄化程序的頻率。
這個值是字串，格式如下：
'EVERY NUMBER TIME_UNITS'
更改下列內容：
NUMBER：正整數。
TIME_UNITS：
DAYS或HOURS。
如未定義，AlloyDB Omni 會每小時執行一次自動資料欄化程序。
大小調整與查詢處理
google_columnar_engine.memory_size_in_mb
| 類型 | Integer |
| 有效值 | 介於 128 到代表執行個體記憶體 70% 的值之間 |
| 預設 | 1 GB 的執行個體記憶體 |
| 執行個體重新啟動 | 是 |
AlloyDB Omni 分配給資料欄儲存庫的執行個體記憶體容量，以 MiB 為單位。
如果未設定這個標記，AlloyDB Omni 會將執行個體記憶體的 1 GB 分配給資料欄儲存庫。
google_columnar_engine.enable_columnar_scan
| 類型 | Boolean |
| 預設 | on |
| 執行個體重新啟動 | 否 |
如果 on，允許 AlloyDB Omni 在處理查詢時存取資料欄儲存庫的內容。
如果這個旗標為 off，而 google_columnar_engine.enabled 為 on，則直欄引擎會保持啟用狀態並保留直欄儲存區，但 AlloyDB Omni 處理查詢時不會使用直欄資料。
google_columnar_engine.omni_storage_cache_directory
這個標記可讓您為資料欄引擎的磁碟快取檔案指定專屬目錄路徑。
| 類型 | String |
| 有效值 | 儲存磁碟快取檔案的單一目錄路徑。 |
| 預設 | 系統會將專屬永久磁碟聲明 (PVC) 的總大小分配給資料欄溢出至磁碟的快取。 |
| 執行個體重新啟動 | 是 |
google_columnar_engine.storage_cache_size
如未指定 google_columnar_engine.omni_storage_cache_directory，您必須啟用磁碟快取，才能啟用儲存空間快取大小。
| 類型 | Integer |
| 有效值 | 1024 ... 2147483647 |
| 預設 | 如未指定 google_columnar_engine.omni_storage_cache_directory，系統會將 5% 的磁碟快取分配給直欄引擎。 |
| 執行個體重新啟動 | 是 |
如果 on，則允許 AlloyDB Omni 為直欄式引擎設定儲存空間快取大小。
如未指定 google_columnar_engine.omni_storage_cache_directory，此標記允許的最大值為磁碟快取總大小的 50%。1000 * google_columnar_engine.memory_size_in_mb 的上限也適用。
維護作業
google_job_scheduler.maintenance_cpu_percentage
| 類型 | Integer |
| 有效值 | 0 ... 100 |
| 預設 | 20 |
| 執行個體重新啟動 | 否 |
資料欄引擎可用於背景處理的執行個體 CPU 容量百分比上限。
google_job_scheduler.max_parallel_workers_per_job
| 類型 | Integer |
| 有效值 | 0 ... 262143 |
| 預設 | 2 |
| 執行個體重新啟動 | 否 |
為執行單一背景處理作業，資料欄引擎可以建立的平行 worker 數量上限。
自動重新整理 - 事件驅動
google_columnar_engine.refresh_threshold_percentage
| 類型 | Integer |
| 有效值 | 1 ... 100 |
| 預設 | 50 |
| 執行個體重新啟動 | 否 |
指定資料欄儲存庫的資料重新整理門檻，以百分比表示。
符合下列條件時，AlloyDB Omni 會重新整理資料欄單元 (資料欄表格中的一組資料區塊) 內的資料：
直欄單位的表格已超出
refresh_threshold_scan_count旗標定義的掃描閾值。資料欄單元基礎資料區塊的無效百分比超過
refresh_threshold_percentage旗標的值。由於直欄資料表所依據的資料列資料發生變更，直欄資料區塊會失效。
google_columnar_engine.refresh_threshold_scan_count
| 類型 | Integer |
| 有效值 | 0 ... 2147483647 |
| 預設 | 5 |
| 執行個體重新啟動 | 否 |
AlloyDB Omni 會針對個別分欄資料表，持續計算該資料表自上次 DML 查詢至今總共執行了幾次掃描作業。refresh_threshold_scan_count 旗標的值會指定任何資料欄表格中，這個計數器的最小值，AlloyDB Omni 必須達到這個值，才能重新整理資料。接著，AlloyDB Omni 會使用 refresh_threshold_percentage 定義的無效區塊門檻，判斷何時要重新整理資料表資料。
如果這個旗標的值設為 0，AlloyDB Omni 會忽略資料表掃描，只使用 refresh_threshold_percentage 來判斷何時應重新整理資料欄資料。
自動重新整理 - 定期和適應性
google_columnar_engine.adaptive_auto_refresh_schedule
| 類型 | String |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
| 允許的最大值 | 2147483647 |
指定 AlloyDB Omni 在執行個體上執行適應性自動重新整理程序的頻率。
這個值是字串，格式如下：
'EVERY NUMBER TIME_UNITS'
更改下列內容：
NUMBER：正整數。
TIME_UNITS：
DAYS或HOURS。
如果未定義，AlloyDB Omni 會每小時執行一次「適應性自動重新整理」程序。
google_columnar_engine. min_adaptive_auto_refresh_blocks
| 類型 | Integer |
| 有效值 | 0 ... 2147483647 |
| 預設 | 50 |
| 執行個體重新啟動 | 否 |
無效的資料塊數量超過 min_adaptive_auto_refresh_blocks 旗標的值。由於直欄資料表所依據的列資料發生變更，直欄資料區塊會失效。
向量化聯結
google_columnar_engine.enable_vectorized_join
| 類型 | Boolean |
| 預設 | off |
| 重新啟動執行個體 | No |
如果是 on，AlloyDB Omni 會自動使用多執行緒向量化作業，提升聯結多個資料表的查詢效能。
詳情請參閱「啟用向量化聯結」。
google_columnar_engine.vectorized_join_threads
| 類型 | Integer |
| 有效值 | 最多可達執行個體 vCPU 數的一半 |
| 預設 | 1 |
| 重新啟動執行個體 | No |
定義向量化聯結運算子可用的並行執行緒數量上限，並透過 enable_vectorized_join 旗標啟用。
您可以定義的值最多為執行個體 vCPU 的一半。舉例來說，在 16 個 vCPU 的執行個體上，這個旗標的最大值為 8。
預先發布版功能
google_columnar_engine.enable_json_support
| 類型 | Boolean |
| 預設 | off |
| 重新啟動執行個體 | No |
如果這個旗標和 enable_raw_format 都設為 on，AlloyDB Omni 允許在資料欄商店中使用 PostgreSQL JSON 和 JSONB 資料型別。
google_columnar_engine.enable_raw_format
| 類型 | Boolean |
| 預設 | off |
| 重新啟動執行個體 | No |
如果這個旗標和 enable_json_support 都設為 on，AlloyDB Omni 就允許資料欄儲存庫使用 PostgreSQL JSON 和 JSONB 資料類型。