AlloyDB 旗標

選取文件版本:

本頁說明 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
執行個體重新啟動

啟用「預覽」中的下列功能:

* 自動維護索引:遞增管理索引,因此當資料集變大時,AlloyDB Omni 會分割大型離群值分區,並盡量提供更佳的 QPS 和搜尋結果。 * 延後建立索引:延後為空白資料列或資料列不足的資料表建立索引。* 四層樹狀結構索引支援超過 10 億個向量資料列的資料表。

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 遙測功能」。