本頁說明 AlloyDB for PostgreSQL 用來啟用及管理各種 AlloyDB 專屬服務功能的資料庫標記。如需 AlloyDB 支援的所有資料庫標記清單,請參閱「支援的資料庫標記」。
標有「執行個體會重新啟動」的旗標表示,每當您在執行個體上設定、移除或修改這類旗標時,AlloyDB 就會重新啟動該執行個體。除非再次修改,否則系統會保留執行個體的旗標值。
alloydb.audit_log_line_prefix
| 類型 | string |
| 預設 | "%m [%p]: [%l-1] db=%d,user=%u |
| 執行個體重新啟動 | 是 |
控制每個稽核記錄行前置的資訊。如果留空,則不會使用前置字串。
alloydb.enable_pgaudit
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管 AlloyDB 執行個體中 pgaudit 擴充功能的可用性。將參數設為 on,然後重新啟動執行個體。然後使用 CREATE
EXTENSION 指令,將 pgaudit 擴充功能新增至執行個體中的個別資料庫。
pgaudit 擴充功能會使用 PostgreSQL 提供的標準記錄功能,提供詳細的工作階段和物件稽核記錄。
alloydb.enable_auto_explain
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管 AlloyDB 執行個體中 auto_explain 擴充功能的可用性。將參數設為 on,然後重新啟動執行個體。
auto_explain 擴充功能可自動記錄緩慢陳述式的執行計畫,以利進行疑難排解等作業。可自動執行 EXPLAIN 指令的功能。
alloydb.enable_pg_bigm
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管 AlloyDB 執行個體中 pg_bigm 擴充功能的可用性。將參數設為 on,然後重新啟動執行個體。然後使用 CREATE
EXTENSION 指令,將 pg_bigm 擴充功能新增至執行個體中的個別資料庫。
pg_bigm 擴充功能會在 PostgreSQL 中提供全文搜尋功能,並使用 2-gram (雙連字) 索引,加快全文搜尋速度。
alloydb.enable_pg_cron
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管 AlloyDB 執行個體中 pg_cron 擴充功能的可用性。將參數設為 on,然後重新啟動執行個體。然後使用 CREATE
EXTENSION 指令,將 pg_cron 擴充功能新增至執行個體中的個別資料庫。
pg_cron 擴充功能提供 PostgreSQL 的 cron 型作業排程器,可在資料庫中以擴充功能的形式執行。這項功能使用的語法與一般 cron 相同,可讓您直接從資料庫排定 PostgreSQL 指令。
alloydb.enable_pg_hint_plan
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管 AlloyDB 執行個體中 pg_hint_plan 擴充功能的可用性。將參數設為 on,然後重新啟動執行個體。然後使用 CREATE EXTENSION 指令,將 pg_hint_plan 擴充功能新增至執行個體中的個別資料庫。
pg_hint_plan 擴充功能可讓您使用提示 (SQL 註解中的說明) 改善 PostgreSQL 執行計畫。
alloydb.enable_pg_wait_sampling
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
啟用後,AlloyDB 就能收集等待事件的取樣統計資料。
將參數設為 on,然後重新啟動執行個體。然後使用 CREATE EXTENSION 指令,將 pg_wait_sampling 擴充功能新增至執行個體中的個別資料庫。
pg_wait_sampling 擴充功能會匯總及摘要等待事件資料。您可以查詢這些檢視畫面,深入瞭解不同等待事件的等待時間、頻率和相對重要性。
alloydb.enable_pglogical
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管 AlloyDB 執行個體中 pglogical 擴充功能的可用性。將參數設為 on,然後重新啟動執行個體。然後使用 CREATE EXTENSION 指令,將 pglogical 擴充功能新增至執行個體中的個別資料庫。
pglogical 擴充功能會使用發布及訂閱模型,為 PostgreSQL 提供邏輯串流複製功能。
alloydb.iam_authentication
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
啟用 Identity and Access Management (IAM) 驗證,搭配 AlloyDB 執行個體使用。
alloydb.logical_decoding
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
在 AlloyDB 執行個體中啟用 PostgreSQL 邏輯解碼基礎架構。
邏輯解碼提供必要的基礎架構,可將資料修改串流至外部消費者。
alloydb.log_throttling_window
| 類型 | integer |
| 預設 | 0 |
| 執行個體重新啟動 | 否 |
控管 AlloyDB 是否記錄在指定時間範圍內收到的重複記錄訊息。
如果設為大於 0 的值,AlloyDB 每次記錄記錄訊息時,都會啟動該秒數的計時器。如果 AlloyDB 在計時器到期前收到相同的記錄訊息,就不會記錄該訊息。計時器到期後,AlloyDB 會將任何略過的訊息計數附加至記錄的下一個相同記錄訊息。
如果設為 0,AlloyDB 會記錄所有重複的記錄訊息。
alloydb.promote_cancel_to_terminate
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 否 |
如果設為 true,AlloyDB 遇到鎖定逾時、陳述式逾時和復原 (重播) 衝突等問題而取消查詢要求時,系統會將要求升級為強制後端終止要求。
AlloyDB 會優先處理取消要求,避免後端停滯,進而阻礙記錄重播和其他後端作業。
alloydb.pg_shadow_select_role
| 類型 | string |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
用於授予查詢 pg_shadow 檢視畫面權限的 PostgreSQL 角色名稱。
alloydb_password
| 類型 | string |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
提供函式,可為 AlloyDB Omni 設定及管理密碼政策。如果應用程式的資料庫使用者是透過內建的密碼驗證方法,向 AlloyDB Omni 進行驗證,您可以強制使用高強度密碼,進一步確保驗證安全。
詳情請參閱「使用密碼政策管理內建驗證」。
alloydb_scann
| 類型 | string |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
提供相關函式,讓 AlloyDB Omni 能以高效能和效率處理向量搜尋工作負載。
詳情請參閱「建立索引和查詢向量」。
alloydb_ai_nl
| 類型 | string |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
提供相關函式,讓您使用自然語言安全地查詢 AlloyDB。 這個擴充功能會與 `parameterized_views` 擴充功能搭配運作,為您的資料強制執行安全層。
詳情請參閱「使用自然語言生成 SQL 查詢」。
parameterized_views
| 類型 | string |
| 預設 | 空字串 |
| 執行個體重新啟動 | 否 |
提供相關函式,在將自然語言查詢轉換為 SQL 查詢時,加入安全層。這項擴充功能會與 alloydb_ai_nl 擴充功能搭配運作。
詳情請參閱「使用自然語言生成 SQL 查詢」。
alloydb_ai_nl.enabled
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管是否要啟用 AlloyDB AI 自然語言功能。
scann.enable_preview_features
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
scann.enable_index_maintenance
| 類型 | boolean |
| 預設 | on |
| 執行個體重新啟動 | 是 |
控管是否啟用自動向量索引維護功能。
scann.max_background_workers
| 類型 | integer |
| 預設 | 1 |
| 執行個體重新啟動 | 是 |
控管用於自動維護向量索引的背景工作站數量。詳情請參閱「提高自動維護作業的處理量」。
scann.maintenance_background_naptime_s
| 類型 | integer |
| 預設 | 1 |
| 執行個體重新啟動 | 是 |
控管自動向量索引維護作業的背景工作執行作業之間的最短延遲時間。預設值為 1 分鐘。
scann.max_allowed_num_levels
| 類型 | integer |
| 預設 | 2 |
| 最小值 | 1 |
| 最大值 | 3 |
| 執行個體重新啟動 | 否 |
決定建立 ScaNN 索引時,max_num_levels 可設定的最高值。
parameterized_views.enabled
| 類型 | boolean |
| 預設 | off |
| 執行個體重新啟動 | 是 |
控管是否啟用參數化檢視畫面功能。
parameterized_views.enabled 標記設定不會自動複製,您必須在每個執行個體上手動複製。您必須在每個副本執行個體上啟用 parameterized_views.enabled 標記,才能在副本上查詢參數化檢視區塊。詳情請參閱「使用 AlloyDB Omni 參數化安全檢視區塊管理應用程式資料安全性」。
parameterized_views.json_results_max_rows
| 類型 | integer |
| 預設 | 1,000,000 |
| 執行個體重新啟動 | 否 |
設定 execute_parameterized_query() 函式傳回的 JSON 結果資料列數量上限。
parameterized_views.json_results_max_size
| 類型 | integer |
| 預設 | 1,048,576 |
| 執行個體重新啟動 | 否 |
設定 execute_parameterized_query() 函式的 JSON 結果大小上限 (KB)。
parameterized_views.max_parallel_workers_per_gather
| 類型 | integer |
| 預設 | -1 |
| 執行個體重新啟動 | 否 |
使用參數化檢視區塊 API 執行查詢時,設定每個執行器節點的平行程序數量上限。-1 表示沒有限制。只有在限制比 max_parallel_workers_per_gather 更嚴格時,這項限制才會生效。
parameterized_views.statement_timeout
| 類型 | integer |
| 預設 | 0 |
| 執行個體重新啟動 | 否 |
設定使用參數化檢視區塊 API 執行的陳述式時間長度上限 (以毫秒為單位)。0 表示沒有限制。只有在限制比 statement_timeout 更嚴格時,這項限制才會生效。
parameterized_views.temp_file_limit
| 類型 | integer |
| 預設 | -1 |
| 執行個體重新啟動 | 否 |
使用參數化檢視區塊 API 執行時,限制每個程序使用的所有暫存檔案總大小 (以 KB 為單位)。-1 表示沒有限制。只有在限制比 temp_file_limit 更嚴格時,這項限制才會生效。
parameterized_views.work_mem
| 類型 | integer |
| 預設 | 0 |
| 執行個體重新啟動 | 否 |
使用參數化檢視區塊 API 執行查詢工作區時,設定可用的記憶體上限 (以 KB 為單位)。0 表示沒有限制。只有在限制比 work_mem 更嚴格時,這項限制才會生效。
vector_assist.enabled
| 類型 | boolean |
| 預設 | on |
| 執行個體重新啟動 | 否 |
控管是否啟用向量輔助功能。
AlloyDB Omni 遙測
| 類型 | boolean |
| 預設 | on |
| 執行個體重新啟動 | 是 |
可讓使用者選擇是否要定期收集 AlloyDB Omni 使用情況和系統指標,並上傳至 Google。如果設為 false,負責遙測的用戶端代理程式就會結束,且不會執行。
詳情請參閱「啟用及停用 AlloyDB Omni 遙測功能」。