Important
Azure Cosmos DB for PostgreSQL 已經走在退役路線上,不再建議新專案使用。 請改用下列兩項服務之一:
針對 PostgreSQL 工作負載,請使用 Azure Database For PostgreSQL 的彈性叢集功能,利用 開放原始碼 Citus 擴充套件中的水平擴展與分散式 PostgreSQL 功能。 關於遷移指引,請參見 migrate to 適用於 PostgreSQL 的 Azure 資料庫 with Elastic Cluster。
對於 NoSQL 工作負載,建議使用 Azure Cosmos DB for NoSQL ,作為分散式資料庫解決方案,包含 99.999% 可用性服務水準協議(SLA)、即時自動擴展,以及跨多區域的自動故障轉移。
有各種伺服器參數會影響適用於 PostgreSQL 的 Azure Cosmos DB 行為,無論是從標準 PostgreSQL,還是適用於 PostgreSQL 的 Azure Cosmos DB。 您可以在 Azure 入口網站中為叢集設定這些參數。 在 [設定] 類別下,選擇 [背景工作角色節點參數] 或 [協調器節點參數]。 這些頁面可讓您設定所有背景工作角色節點的參數,或只設定協調器節點的參數。
Azure Cosmos DB for PostgreSQL 參數
Note
執行舊版 Citus 擴充功能的叢集可能無法提供下列所有參數。
一般設定
citus.use_secondary_nodes (列舉)
設定在選擇 SELECT 查詢節點時要使用的原則。 如果設定為 「一律」,則規劃工具只會查詢pg_dist_node中標示為「次要」節點的節點。
此列舉的支援值為:
- 從不: (預設)所有讀取皆在主要節點上進行。
- 永遠: 讀取則改對次要節點執行,且 insert/update 語句會被停用。
citus.cluster_name (文字)
通知協調器節點規劃工具其座標的叢集。 設定cluster_name之後,規劃工具會單獨查詢該叢集中的背景工作節點。
citus.enable_version_checks (布林值 )
升級適用於 PostgreSQL 的 Azure Cosmos DB 版本需要重新啟動伺服器(以挑選新的共用連結庫),後面接著 ALTER EXTENSION UPDATE 命令。 執行這兩個步驟失敗可能會導致錯誤或當機。 因此,適用於 PostgreSQL 的 Azure Cosmos DB 會驗證程式代碼的版本和擴充功能相符的版本,如果不符合,就會發生錯誤。
這個值預設為 true,而且對協調器有效。 在罕見的情況下,複雜的升級程式可能需要將此參數設定為 false,因此停用檢查。
citus.log_distributed_deadlock_detection (布爾值)
是否要在伺服器記錄檔中記錄分散式死結偵測相關處理。 默認為 false。
citus.distributed_deadlock_detection_factor (浮點)
設定檢查分散式死結之前要等候的時間。 特別是等候時間是此值乘以PostgreSQL的 deadlock_timeout 設定。 預設值為 2。 的值 -1 會停用分散式死結偵測。
citus.node_connection_timeout (整數)
GUC 會 citus.node_connection_timeout 設定等候連線建立的最大持續時間(以毫秒為單位)。 如果逾時在建立至少一個背景工作角色連線之前經過,Azure Cosmos DB for PostgreSQL 就會引發錯誤。 此 GUC 會影響協調器與背景工作角色的連線,以及彼此之間背景工作角色的連線。
- 預設值:五秒
- 最小值:10 毫秒
- 最大值:一小時
-- set to 30 seconds
ALTER DATABASE foo
SET citus.node_connection_timeout = 30000;
citus.log_remote_commands (布爾值)
記錄協調器傳送給背景工作節點的所有命令。 例如:
-- reveal the per-shard queries behind the scenes
SET citus.log_remote_commands TO on;
-- run a query on distributed table "github_users"
SELECT count(*) FROM github_users;
輸出會顯示數個在背景工作角色上執行的查詢,因為協調器上的單一 count(*) 查詢。
NOTICE: issuing SELECT count(*) AS count FROM public.github_events_102040 github_events WHERE true
DETAIL: on server citus@private-c.demo.postgres.database.azure.com:5432 connectionId: 1
NOTICE: issuing SELECT count(*) AS count FROM public.github_events_102041 github_events WHERE true
DETAIL: on server citus@private-c.demo.postgres.database.azure.com:5432 connectionId: 1
NOTICE: issuing SELECT count(*) AS count FROM public.github_events_102042 github_events WHERE true
DETAIL: on server citus@private-c.demo.postgres.database.azure.com:5432 connectionId: 1
... etc, one for each of the 32 shards
citus.show_shards_for_app_name_prefixes (文字)
根據預設,適用於 PostgreSQL 的 Azure Cosmos DB 會從 PostgreSQL 提供給 SQL 用戶端的數據表清單中隱藏分區。 這樣做是因為每個分散式數據表有多個分區,而分區可能會分散SQL用戶端的注意力。
citus.show_shards_for_app_name_prefixes GUC 允許針對想要查看這些分區的選取客戶端顯示分區。 其預設值為 ''。
-- show shards to psql only (hide in other clients, like pgAdmin)
SET citus.show_shards_for_app_name_prefixes TO 'psql';
-- also accepts a comma separated list
SET citus.show_shards_for_app_name_prefixes TO 'psql,pg_dump';
使用citus.override_table_visibility可以完全停用分區隱藏。
citus.override_table_visibility (布林值 )
判斷citus.show_shards_for_app_name_prefixes是否為使用中狀態。 預設值為 『true』。 當設定為 『false』 時,所有用戶端應用程式都會看到分區。
citus.use_citus_managed_tables (布林值 )
允許背景工作節點上的查詢存取新的 本機數據表 。 啟用時,將所有新建立的數據表新增至 Citus 元數據。 默認值為 『false』。
citus.rebalancer_by_disk_size_base_cost (整數)
使用by_disk_size重新平衡策略,每個分區群組都會以位元組為單位來取得新增至其實際磁碟大小的成本。 當部分分區中幾乎沒有數據時,這個值可用來避免建立不正確的平衡。 假設即使是空的分區也有一些成本,因為平行處理原則和因為空分區群組可能會在未來成長。
預設值為 100MB。
查詢統計資料
citus.stat_statements_purge_interval (整數)
設定維護精靈從 移除記錄的頻率。 此組態值會設定以秒為單位清除之間的時間間隔,預設值為10。 值為 0 會停用清除。
SET citus.stat_statements_purge_interval TO 5;
此參數在協調器上有效,而且可以在運行時間變更。
citus.stat_statements_max (整數)
要儲存在 citus_stat_statements 的最大資料列數。 默認值為 50000,而且可以變更為 1000 - 10000000 範圍中的任何值。 每個數據列都需要 140 個字節的記憶體,因此設定 stat_statements_max 為 10M 的最大值會耗用 1.4 GB 的記憶體。
在 PostgreSQL 重新啟動之前,變更此 GUC 不會生效。
citus.stat_statements_track (列舉)
記錄 的 citus_stat_statements 統計數據需要額外的CPU資源。
當資料庫發生載入時,系統管理員可以藉由將 設定 citus.stat_statements_track 為 none來停用語句追蹤。
- all: (預設)追蹤所有語句。
- 無: 關閉追蹤功能。
citus.stat_tenants_untracked_sample_rate
中 citus_stat_tenants新租用戶的取樣率。 速率可以是 介於和0.0之間的1.0範圍。 預設值表示 1.0 會取樣 100% 的未追蹤租用戶查詢。 將它設定為較低的值表示已追蹤的租使用者已取樣 100% 查詢,但目前未追蹤的租使用者只會以提供的速率取樣。
數據載入
citus.multi_shard_commit_protocol (列舉)
設定在哈希分散式數據表上執行 COPY 時要使用的認可通訊協定。 在每個個別分區放置上,COPY 會在交易區塊中執行,以確保在 COPY 期間發生錯誤時不會內嵌任何數據。 不過,在某些情況下,COPY 會在所有位置上成功,但在所有交易認可之前發生(硬體)失敗。 此參數可用來防止在該案例中遺失數據,方法是選擇下列認可通訊協定:
- 2pc: (預設)對分片放置執行 COPY 的交易,首先會以 PostgreSQL 的 兩階段提交 方式準備,然後再提交。 失敗的認可可以分別使用 COMMIT PREPARED 或 ROLLBACK PREPARED 手動復原或中止。 使用 2pc 時, 應該在所有背景工作角色上增加max_prepared_transactions ,通常是與max_connections相同的值。
- 1 件: 對分片放置執行 COPY 的交易會在單一輪內提交。 如果複製在所有放置成功之後認可失敗,數據可能會遺失(罕見)。
citus.shard_replication_factor (整數)
設定分區的復寫因數,也就是放置分區的節點數目,預設為1。 這個參數可以在運行時間設定,而且在協調器上有效。 此參數的理想值取決於叢集的大小和節點失敗率。 例如,如果您執行大型叢集並觀察節點失敗的頻率,您可以增加此複寫因數。
Planner 設定
citus.local_table_join_policy (列舉)
此 GUC 會決定在本機和分散式數據表之間聯結時,適用於 PostgreSQL 的 Azure Cosmos DB 如何行動數據。 自定義聯結原則有助於減少背景工作節點之間傳送的數據量。
適用於 PostgreSQL 的 Azure Cosmos DB 會視需要將本機或分散式數據表傳送至節點,以支援聯結。 複製數據表數據稱為「轉換」。 如果本機數據表已轉換,則會傳送給需要其數據以執行聯結的任何背景工作角色。 如果分散式數據表已轉換,則會在協調器中收集它以支援聯結。 適用於 PostgreSQL 的 Azure Cosmos DB 規劃工具只會傳送執行轉換的必要數據列。
有四種模式可用來表示轉換喜好設定:
- auto:(預設)Azure Cosmos DB for PostgreSQL 會將所有本地或全部分散式資料表轉換為支援本地與分散式資料表連接。 適用於 PostgreSQL 的 Azure Cosmos DB 決定要使用啟發學習法進行轉換。 如果分散式數據表是使用唯一索引的常數篩選來聯結,則會轉換分散式數據表(例如主鍵)。 轉換可確保在背景工作角色之間移動的數據較少。
- 從不:Azure Cosmos DB for PostgreSQL 不允許本地資料表與分散式資料表之間的連接。
- prefer-local:Azure Cosmos DB for PostgreSQL 偏好將本地資料表轉換為支援本地及分散式資料表連接。
- prefer-distributed:Azure Cosmos DB for PostgreSQL 偏好將分散式資料表轉換為支援本地與分散式資料表連接。 如果分散式數據表非常龐大,使用此選項可能會導致背景工作角色之間移動大量數據。
例如,假設 citus_table 是數據行 x所散發的分散式數據表,而該 postgres_table 數據表是本機數據表:
CREATE TABLE citus_table(x int primary key, y int);
SELECT create_distributed_table('citus_table', 'x');
CREATE TABLE postgres_table(x int, y int);
-- even though the join is on primary key, there isn't a constant filter
-- hence postgres_table will be sent to worker nodes to support the join
SELECT * FROM citus_table JOIN postgres_table USING (x);
-- there is a constant filter on a primary key, hence the filtered row
-- from the distributed table will be pulled to coordinator to support the join
SELECT * FROM citus_table JOIN postgres_table USING (x) WHERE citus_table.x = 10;
SET citus.local_table_join_policy to 'prefer-distributed';
-- since we prefer distributed tables, citus_table will be pulled to coordinator
-- to support the join. Note that citus_table can be huge.
SELECT * FROM citus_table JOIN postgres_table USING (x);
SET citus.local_table_join_policy to 'prefer-local';
-- even though there is a constant filter on primary key for citus_table
-- postgres_table will be sent to necessary workers because we are using 'prefer-local'.
SELECT * FROM citus_table JOIN postgres_table USING (x) WHERE citus_table.x = 10;
citus.limit_clause_row_fetch_count (整數)
設定要針對 limit 子句優化擷取每個工作的數據列數目。 在某些情況下,選取具有 limit 子句的查詢可能需要從每個工作擷取所有數據列以產生結果。 在這些情況下,以及近似值會產生有意義的結果,此組態值會設定要從每個分區擷取的數據列數目。 默認會停用限制近似值,且此參數設定為 -1。 此值可以在運行時間設定,而且在協調器上有效。
citus.count_distinct_error_rate (浮點)
適用於 PostgreSQL 的 Azure Cosmos DB 可以使用 postgresql-hll 擴充功能來計算 count(distinct) 近似值。 此組態專案會在計算 count(distinct) 時設定所需的錯誤率。 0.0,這是預設值,會停用 count(distinct] 的近似值:和 1.0 不提供結果精確度的保證。 建議您將此參數設定為 0.005,以獲得最佳結果。 此值可以在運行時間設定,而且在協調器上有效。
citus.task_assignment_policy (列舉)
Note
只有當shard_replication_factor大於一個,或針對reference_tables進行查詢時,才適用此 GUC。
設定將工作指派給背景工作時要使用的原則。 協調器會根據分區位置將工作指派給背景工作。 此組態值會指定要在進行這些指派時使用的原則。 目前,有三個可能的工作指派原則可供使用。
- 貪婪: 貪婪政策是預設做法,目標是將工作分配給員工。
- 循環賽: 輪詢政策以輪轉方式指派任務給工作者,並在不同複本間交替執行。 相較於背景工作角色數目,當數據表的分區計數較低時,此原則可提供更好的叢集使用率。
- 第一複製品: 第一複本政策根據分片放置(複本)的插入順序指派任務。 換句話說,分區的片段查詢會指派給具有該分區第一個複本的背景工作角色。 這個方法可讓您對哪些節點使用哪些分區提供強式保證(也就是更強的記憶體落地保證)。
這個參數可以在運行時間設定,而且在協調器上有效。
citus.enable_non_colocated_router_query_pushdown (布林值)
針對參考非共置分散式數據表的查詢啟用路由器規劃工具。
路由器規劃工具只會針對參考共置分散式數據表的查詢啟用,否則分區可能不在相同的節點上。 啟用此旗標可針對參考這類數據表的查詢進行優化,但在重新平衡分區或改變這些數據表的分區計數之後,查詢可能無法運作。
預設值為 off。
中繼數據傳輸
citus.max_intermediate_result_size (integer)
無法向下推送至背景工作節點以進行執行,以及複雜子查詢之 CTE 的中繼結果 KB 大小上限。 默認值為 1 GB,且值為 -1 表示沒有限制。 超過限制的查詢會取消併產生錯誤訊息。
DDL
citus.enable_schema_based_sharding
將 參數設定為 ON,所有建立的架構預設都會散發。 分散式結構描述會自動與個別共置群組相關聯,因此,以這些結構描述所建立的資料表會轉換成沒有分片鍵的共置的分散式資料表。 您可以針對個別工作階段修改此設定。
如需使用此 GUC 的範例,請參閱 如何設計微服務。
執行程式組態
General
citus.all_modifications_commutative
適用於 PostgreSQL 的 Azure Cosmos DB 會強制執行通勤性規則,並取得適當的鎖定來修改作業,以確保行為正確性。 例如,它假設 INSERT 語句會與其他 INSERT 語句一起通勤,但不會使用 UPDATE 或 DELETE 語句。 同樣地,它假設 UPDATE 或 DELETE 語句不會與另一個 UPDATE 或 DELETE 語句通勤。 此預防措施表示 UPDATEEs 和 DELETE 需要適用於 PostgreSQL 的 Azure Cosmos DB 取得更強的鎖定。
如果您有使用 INSERT 或其他 UPDATEE 的 UPDATE 語句,您可以將此參數設定為 true 來放寬這些通勤性假設。 當此參數設定為 true 時,所有命令都會被視為通勤,並宣告共用鎖定,這可以改善整體輸送量。 這個參數可以在運行時間設定,而且在協調器上有效。
citus.remote_task_check_interval (整數)
設定 Azure Cosmos DB for PostgreSQL 檢查工作追蹤器執行程式所管理作業狀態的頻率。 預設為10毫秒。 協調器會將工作指派給背景工作,然後定期檢查每個工作的進度。 此組態值會設定兩次後續檢查之間的時間間隔。 此參數在協調器上有效,而且可以在運行時間設定。
citus.task_executor_type (列舉)
適用於 PostgreSQL 的 Azure Cosmos DB 有三種執行程式類型,可用於執行分散式 SELECT 查詢。 您可以藉由設定此組態參數來選取所需的執行程式。 此參數的接受值為:
- 適應性: 預設值。 它最適合快速回應涉及跨多個分區的匯總和共置聯結的查詢。
- 任務追蹤器: 任務追蹤執行器非常適合用於需要在工作節點間重新分配資料並高效管理的長期複雜查詢。
- real-time: (已棄用)與自適應執行器類似,但彈性較低,且可能對工作節點造成更多連線壓力。
這個參數可以在運行時間設定,而且在協調器上有效。
citus.multi_task_query_log_level (enum) {#multi_task_logging}
設定任何產生多個工作的查詢的記錄層級(也就是叫用多個分區)。 記錄在多租使用者應用程式移轉期間很有用,因為您可以選擇針對這類查詢發生錯誤或警告,以尋找它們,並將tenant_id篩選新增至它們。 這個參數可以在運行時間設定,而且在協調器上有效。 此參數的預設值為 『off』。
此列舉的支援值為:
- 關閉: 關閉記錄任何產生多個任務(即跨越多個分片)的查詢
- 除錯: 以 DEBUG 嚴重性等級記錄陳述式。
- 日誌: 以 LOG 嚴重性等級記錄陳述。 記錄行包含執行的 SQL 查詢。
- 注意事項: 以 NOTICE 嚴重性等級記錄陳述。
- 警告: 以 WARNING 嚴重程度記錄陳述式。
- 錯誤: 以 ERROR 嚴重性等級記錄陳述式。
在開發測試期間使用 error ,以及較低的記錄層級,例如 log 在實際生產部署期間,使用可能會很有用。
log選擇會導致多任務查詢出現在資料庫記錄中,而查詢本身會顯示在 「STATEMENT」 之後。
LOG: multi-task query about to be executed
HINT: Queries are split to multiple tasks if they have to be split into several queries on the workers.
STATEMENT: select * from foo;
citus.propagate_set_commands (列舉)
決定哪些 SET 命令會從協調器傳播到背景工作角色。 此參數的預設值為 『none』。
支援的值為:
- 無: 不會傳遞任何 SET 指令。
- local: 僅傳遞 SET LOCAL 指令。
citus.create_object_propagation (列舉)
控制所支持物件的交易中 CREATE 語句的行為。
在多語句交易區塊中建立物件時,適用於 PostgreSQL 的 Azure Cosmos DB 會循序模式切換,以確保在稍後的分區語句中可以看到已建立的物件。 不過,切換至循序模式不一定是可取的。 藉由覆寫此行為,用戶可以在建立新物件時取捨效能,以取得完整的交易一致性。
此參數的預設值為 『immediate』。
支援的值為:
- 即時: 在嘗試建立類型前,若平行操作如 create_distributed_table 發生,則會引發錯誤。
- 自動: 在分散式資料表上以平行運算共享交易時,延後建立型別。 在不同節點上存在哪些資料庫對象之間可能會有一些不一致的情況。
- 延遲: 回復到 11.0 之前的行為,類似自動,但帶有其他細微的角落情況。 除非您需要真正的回溯相容性,否則建議您將自動設定延遲。
如需此 GUC 作用中的範例,請參閱 類型傳播。
citus.enable_repartition_joins (布林值 )
一般而言,嘗試與調適型執行程序執行重新分割聯結失敗,並出現錯誤訊息。 不過設定 citus.enable_repartition_joins 為 true 可讓適用於 PostgreSQL 的 Azure Cosmos DB 暫時切換到工作追蹤器執行程式來執行連結。 預設值為 false。
citus.enable_repartitioned_insert_select (布林值 )
根據預設,INSERT INTO ... 無法向下推送的SELECT語句嘗試從SELECT語句重新分割數據列,並在背景工作角色之間傳輸數據列以進行插入。 不過,如果目標數據表有太多分區,則重新分割可能無法正常執行。 判斷如何分割結果時,處理分區間隔的額外負荷太大。
您可以將 設定 citus.enable_repartitioned_insert_select 為 false,手動停用重新分割。
citus.enable_binary_protocol (布林值 )
將此參數設定為 true 會指示協調器節點使用 PostgreSQL 的二進位串行化格式(如果適用的話)來與背景工作角色傳輸數據。 某些數據行類型不支援二進位串行化。
當背景工作角色必須傳回大量數據時,啟用此參數最有用。 例如,當要求許多數據列、數據列有許多數據行,或是使用類似 postgresql-hll 擴充功能的寬型別 hll 時。
預設值為 true。 當設定為 false時,所有結果都會以文字格式編碼和傳輸。
citus.max_adaptive_executor_pool_size (integer)
Max_adaptive_executor_pool_size限制目前會話的背景工作連線。 此 GUC 適用於:
- 防止單一後端取得所有背景工作資源
- 提供優先順序管理:指定低max_adaptive_executor_pool_size的低優先順序會話,以及具有較高值的高優先順序會話
預設值為 16。
citus.executor_slow_start_interval (整數)
開啟與相同背景工作節點連線之間的毫秒等候時間。
當多分區查詢的個別工作需要一些時間時,它們通常可以透過單一(通常已快取的)連線來完成。 為了避免重複開啟更多連線,執行程式會在連線嘗試之間等候設定的毫秒數。 在間隔結束時,它會增加下次允許開啟的連接數目。
對於長時間的查詢(需要 >500 毫秒的時間),緩慢的開始可能會增加延遲,但對於短查詢而言,速度會比較快。 預設值為 10 毫秒。
citus.max_cached_conns_per_worker (integer)
每個後端都會開啟與背景工作角色的連線,以查詢分區。 在交易結束時,設定的連線數目會保持開啟,以加速後續的命令。 增加此值可減少多分區查詢的延遲,但也會增加背景工作角色的額外負荷。
預設值是 1。 較大的值,例如 2,對於使用少量並行會話的叢集而言可能很有説明,但進一步執行並不明智(例如,16 會太高)。
citus.force_max_query_parallelization (布林值 )
模擬已被取代且目前不存在的實時執行程式。 此參數可用來儘可能開啟多個連線,以最大化查詢平行處理。
啟用此 GUC 時,適用於 PostgreSQL 的 Azure Cosmos DB 會強制調適型執行程式在執行平行分散式查詢時盡可能使用盡可能多的連線。 如果未啟用,執行程式可能會選擇使用較少的連線來優化整體查詢執行輸送量。 在內部,將此設定為 true 最終會使用每個工作的一個連線。
此參數很有用的其中一個位置是交易,其第一個查詢是羽量型且需要少數連線,而後續查詢會受益於更多連線。 適用於 PostgreSQL 的 Azure Cosmos DB 會根據第一個語句決定要在交易中使用的連線數目,除非我們使用 GUC 提供提示,否則可能會節流其他查詢。
BEGIN;
-- add this hint
SET citus.force_max_query_parallelization TO ON;
-- a lightweight query that doesn't require many connections
SELECT count(*) FROM table WHERE filter = x;
-- a query that benefits from more connections, and can obtain
-- them since we forced max parallelization above
SELECT ... very .. complex .. SQL;
COMMIT;
預設值為 false。
工作追蹤器執行程序設定
citus.task_tracker_delay (整數)
此參數會將工作管理回合與預設值之間的工作追蹤器睡眠時間設定為 200 毫秒。 工作追蹤器程式會定期喚醒、逐一查看指派給它的所有工作,以及排程和執行這些工作。 然後,工作追蹤器會睡眠一段時間,然後再再次執行這些工作。 此組態值會決定該睡眠期間的長度。 此參數對背景工作角色有效,而且必須在 postgresql.conf 檔案中變更。 編輯組態檔之後,使用者可以傳送 SIGHUP 訊號或重新啟動伺服器,讓變更生效。
您可以藉由減少管理回合之間的時間差距,來減少因工作追蹤器執行程式所造成的延遲而減少此參數。 當分區查詢很短時,減少延遲會很有用,因此會定期更新其狀態。
citus.max_assign_task_batch_size (integer)
協調器上的工作追蹤器執行程式會以批次方式將工作分批指派給背景工作背景工作。 此參數會設定單一批次中要指派的工作數目上限。 選擇較大的批次大小可加快工作分派。 不過,如果背景工作數目很大,則所有背景工作可能需要較長的時間才能取得工作。 這個參數可以在運行時間設定,而且在協調器上有效。
citus.max_running_tasks_per_node (integer)
工作追蹤器會排程並視需要執行指派給它的工作。 此組態值會設定在任何指定時間於一個節點上同時執行的工作數目上限,且預設為8。
此限制可確保您同時沒有許多工作達到磁碟,並有助於避免磁碟 I/O 爭用。 如果您的查詢是從記憶體或 SSD 提供,您可以增加max_running_tasks_per_node而不需太多考慮。
citus.partition_buffer_size (整數)
將分割區作業使用的緩衝區大小設定為8 MB。 當聯結兩個大型數據表時,適用於 PostgreSQL 的 Azure Cosmos DB 可讓數據表數據重新分割成多個檔案。 在此分割區緩衝區填滿之後,重新分割的數據會排清到磁碟上的檔案中。 此組態專案可以在運行時間設定,而且對背景工作角色有效。
說明輸出
citus.explain_all_tasks (布林值 )
根據預設,適用於 PostgreSQL 的 Azure Cosmos DB 會在分散式查詢上執行 EXPLAIN 時顯示單一任意工作的輸出。 在大部分情況下,說明輸出在工作之間很類似。 有時候,有些工作會以不同的方式進行規劃,或執行時間更高。 在這些情況下,啟用此參數會很有用,之後 EXPLAIN 輸出會包含所有工作。 說明所有工作可能會導致 EXPLAIN 需要較長的時間。
citus.explain_analyze_sort_method (列舉)
決定 EXPLAIN ANALYZE 輸出中工作的排序方法。
citus.explain_analyze_sort_method 的預設值為 execution-time。
支援的值為:
- execution-time: 依執行時間排序。
- taskId: 依任務 ID 排序。
Managed PgBouncer 參數
您可以在單一節點或協調器上設定下列 受控 PgBouncer 參數。
| 參數名稱 | Description | 預設值 |
|---|---|---|
| pgbouncer.default_pool_size(pgbouncer 默認池大小) | 將此參數值設定為每位使用者/資料庫配對的連線數目。 | 295 |
| pgbouncer.ignore_startup_parameters | PgBouncer 可以忽略的參數逗號分隔清單。 例如,您可以讓 PgBouncer 忽略 extra_float_digits 參數。 允許某些參數,其他所有參數都會引發錯誤。 需要此能力,才能容許在啟動封包中無條件地設定 『extra_float_digits=2』 的過度輸入 JDBC。 如果您使用報告錯誤的連結庫,請使用此選項, 例如 pq: unsupported startup parameter: extra_float_digits。 |
extra_float_digits,ssl_renegotiation_limit |
| pgBouncer.max_client_conn | 將此參數值設定為您想要支援的 PgBouncer 用戶端連線數目上限。 | 2000 |
| pgBouncer.min_pool_size | 如果低於此數字,請新增更多伺服器連線至集區。 | 0 (已停用) |
| pgBouncer.pool_mode | 將此參數值設定為 TRANSACTION 以進行交易共用 (這是大部分工作負載的建議設定)。 | 交易 |
| pgbouncer.query_wait_timeout | 允許查詢等候執行的時間上限 (以秒為單位)。 如果在該時間內未將查詢指派給伺服器,用戶端就會中斷連線。 | 20 秒 |
| pgbouncer.server_idle_timeout | 如果伺服器連線已閑置超過此數秒,則會關閉。 如果為 0,則會停用此逾時。 | 60 秒 |
PostgreSQL 參數
- DateStyle - 設定日期與時間值的顯示格式
- IntervalStyle - 設定區間值的顯示格式
- TimeZone - 設定顯示與解讀時間戳記的時區
- application_name - 設定要在統計與記錄中報告的應用程式名稱
- array_nulls - 允許陣列中輸入 NULL 元素
- autovacuum - 啟動 autovacuum 子程序
- autovacuum_analyze_scale_factor - 分析前的元組插入、更新或刪除次數,佔 reltuple 的比例
- autovacuum_analyze_threshold - 分析前的最少元組插入、更新或刪除次數
- autovacuum_naptime - 在自動吸塵器運行之間休息的時間
- autovacuum_vacuum_cost_delay - 自動吸塵器的真空成本延遲以毫秒為單位
- autovacuum_vacuum_cost_limit - 自動吸塵器午睡前可查的吸塵費用金額
- autovacuum_vacuum_scale_factor - vacuum 前元組的更新或刪除次數,佔 reltuple 的比例
- autovacuum_vacuum_threshold - 在真空前的最少元組更新或刪除次數
- autovacuum_work_mem - 設定每個自動真空工作程序所使用的最大記憶體
- backend_flush_after - 先前執行的寫入資料會刷新至磁碟的頁數
- backslash_quote - 設定字串字元是否允許使用「'」
- bgwriter_delay - 背景作家在回合間的睡眠時間
- bgwriter_flush_after - 先前執行的寫入資料會刷新至磁碟的頁數
- bgwriter_lru_maxpages - 背景寫入器每回合需刷新的最大 LRU 頁面數
- bgwriter_lru_multiplier - 每回合可釋放的緩衝區平均使用量的倍數
- bytea_output - 設定 bytea 的輸出格式
- check_function_bodies - 在 CREATE FUNCTION 期間檢查函數主體
- checkpoint_completion_target - 檢查點期間清除髒緩衝區的時間,佔檢查點間隔的百分比
- checkpoint_timeout - 設定自動 WAL 檢查點之間的最長時間
- checkpoint_warning - 若檢查點區段填得比此更頻繁,則啟用警告
- client_encoding - 設定用戶端的字元集編碼
- client_min_messages - 設定傳送給用戶端的訊息層級
- commit_delay - 設定交易提交與將 WAL 刷新至磁碟之間的延遲(微秒)
- commit_siblings - 設定執行commit_delay前的最小同時進行交易數
- constraint_exclusion - 允許規劃器使用限制條件來優化查詢
- cpu_index_tuple_cost - 設定規劃器對索引掃描中處理每個索引項目的成本估算
- cpu_operator_cost - 設定規劃者對處理每個操作員或函數呼叫的成本估算
- cpu_tuple_cost - 設定規劃器對處理每個元組(列)成本的估算
- cursor_tuple_fraction - 設定規劃器對游標列中被擷取比例的估計值
- deadlock_timeout - 設定等待鎖定後檢查死鎖的時間(以毫秒為單位)
- debug_pretty_print - 縮排解析與規劃樹狀顯示
- debug_print_parse - 記錄每個查詢的解析樹
- debug_print_plan - 記錄每個查詢的執行計畫
- debug_print_rewritten - 記錄每個查詢重寫的解析樹
- default_statistics_target - 設定預設統計目標
- default_tablespace - 設定預設表格空間以建立表格與索引
- default_text_search_config - 設定預設文字搜尋設定
- default_transaction_deferrable - 設定新交易的預設可延期狀態
- default_transaction_isolation - 設定每筆新交易的交易隔離等級
- default_transaction_read_only - 設定新交易的預設唯讀狀態
- default_with_oids - 預設會建立具有 OID 的新資料表
- effective_cache_size - 設定規劃器對磁碟快取大小的假設
- enable_bitmapscan - 啟用規劃器使用 點陣圖掃描計畫
- enable_gathermerge - 啟用規劃者使用 Gather 合併計畫
- enable_hashagg - 啟用規劃師使用雜湊聚合計畫
- enable_hashjoin - 啟用規劃器使用雜湊連接計畫
- enable_indexonlyscan - 啟用規劃器使用僅索引掃描的計畫
- enable_indexscan - 啟用規劃者使用索引掃描計畫
- enable_material - 允許規劃者使用實體化
- enable_mergejoin - 啟用規劃者使用合併連接計畫
- enable_nestloop - 啟用規劃器使用巢狀迴圈連接計畫
- enable_seqscan - 啟用規劃師使用序列掃描計畫
- enable_sort - 啟用規劃工具使用明確的排序步驟
- enable_tidscan - 啟用規劃者使用 TID 掃描計畫
- escape_string_warning - 警告普通字串字串中反斜線跳脫
- exit_on_error - 遇到任何錯誤時終止工作階段
- extra_float_digits - 設定浮點數值顯示的位數
- force_parallel_mode - 強制使用平行查詢功能
- from_collapse_limit - 設定 FROM 清單大小,超過此尺寸子查詢不會被摺疊
- geqo - 實現遺傳查詢最佳化
- geqo_effort - GEQO:用工量設定其他GEQO參數的預設值
- geqo_generations - GEQO:演算法的迭代次數
- geqo_pool_size - GEQO:人口中的個體數
- geqo_seed - GEQO:隨機路徑選擇的種子
- geqo_selection_bias - GEQO:族群內的選擇壓力
- geqo_threshold - 設定超過 GEQO 使用範圍的 FROM 項目門檻
- gin_fuzzy_search_limit - 設定 GIN 精確搜尋時允許的最大結果
- gin_pending_list_limit - 設定 GIN 索引待處理清單的最大大小
- idle_in_transaction_session_timeout - 設定任何閒置交易的最大允許時間
- join_collapse_limit - 設定 FROM 清單大小,超過此尺寸後 JOIN 結構不會被平坦化
- lc_monetary - 設定金額格式化的語系
- lc_numeric - 設定數字格式的語系
- lo_compat_privileges - 啟用對大型物件權限檢查的向後相容模式
- lock_timeout - 設定任何鎖定等待時間的最大允許時間(以毫秒為單位)。 0 關閉此功能
- log_autovacuum_min_duration - 設定自動吸塵器動作記錄的最短執行時間
- log_connections - 記錄每一次成功連線
- log_destination - 設定伺服器日誌輸出的目的地
- log_disconnections - 記錄工作階段結束時段,包括持續時間
- log_duration - 記錄每個完成的 SQL 陳述式的持續時間
- log_error_verbosity - 設定已記錄訊息的詳細程度
- log_lock_waits - 記錄長鎖等待時間
- log_min_duration_statement - 設定超過該時間的陳述式記錄的最短執行時間(以毫秒為單位)。 -1 會停用記錄語句持續時間
- log_min_error_statement - 將所有產生此等級或以上錯誤的語句記錄為
- log_min_messages - 設定已記錄的訊息層級
- log_replication_commands - 記錄每個複寫指令
- log_statement - 設定記錄的語句類型
- log_statement_stats - 對每個查詢,將累積效能統計資料寫入伺服器日誌
- log_temp_files - 記錄超過此千位元組數的暫存檔案的使用情況
- maintenance_work_mem - 設定維護作業所使用的最大記憶體
- max_parallel_workers - 設定同時可啟用的最大平行工作者數量
- max_parallel_workers_per_gather - 設定每個執行節點的最大平行程序數量
- max_pred_locks_per_page - 設定每頁條件鎖定元組的最大數量
- max_pred_locks_per_relation - 設定每個關係中被謂詞鎖定的頁面與元組的最大數量
- max_standby_archive_delay - 設定熱備援伺服器處理封存 WAL 資料時取消查詢的最大延遲時間
- max_standby_streaming_delay - 設定熱備援伺服器處理串流 WAL 資料時取消查詢前的最大延遲時間
- max_sync_workers_per_subscription - 每個訂閱的最大資料表同步工作者數
- max_wal_size - 設定觸發檢查點的 WAL 大小
- min_parallel_index_scan_size - 設定平行掃描所需的最小索引資料量
- min_wal_size - 設定最小大小以縮小 WAL 為
- operator_precedence_warning - 對自 PostgreSQL 9.4 以來意義變更的結構發出警告
- parallel_setup_cost - 設定規劃器對啟動平行查詢工作程序成本的估算
- parallel_tuple_cost - 設定規劃器對每個元組(列)從工作者傳遞至主後端的成本估算
- pg_stat_statements.save - 在伺服器關機期間儲存pg_stat_statements統計資料
- pg_stat_statements.track - 選擇哪些語句要被追蹤pg_stat_statements
- pg_stat_statements.track_utility - 選擇是否由pg_stat_statements追蹤工具指令
- quote_all_identifiers - 產生 SQL 片段時,請引用所有識別碼
- random_page_cost - 設定規劃器對非順序擷取磁碟頁面成本的估算
- row_security - 啟用列安全性
- search_path - 設定非結構限定名稱的結構搜尋順序
- seq_page_cost - 設定規劃器對連續擷取磁碟頁面成本的估算
- session_replication_role - 設定會話的觸發條件與重寫規則的行為
- standard_conforming_strings - 原因「......」字串來處理反斜線
- statement_timeout - 設定任何語句的最大允許持續時間(以毫秒為單位)。 0 關閉此功能
- synchronize_seqscans - 啟用同步的序列掃描
- synchronous_commit - 設定目前交易的同步等級
- tcp_keepalives_count - TCP 保持活重傳的最大次數
- tcp_keepalives_idle - TCP 保活通知發出間隔時間
- tcp_keepalives_interval - TCP 保持活重傳之間的間隔時間
- temp_buffers - 設定每個資料庫工作階段所使用的最大暫存緩衝區數量
- temp_tablespaces - 設定用於暫存資料表與排序檔案的表空間
- track_activities - 收集執行指令的相關資訊
- track_counts - 收集資料庫活動統計資料
- track_functions - 收集資料庫活動的功能層級統計資料
- track_io_timing - 收集資料庫 I/O 活動的時序統計資料
- transform_null_equals - 將「expr=NULL」視為「expr IS NULL」
- vacuum_cost_delay - 真空成本延遲(毫秒)
- vacuum_cost_limit - 午睡前可用的吸塵器費用
- vacuum_cost_page_dirty - 頁面被真空污染時的真空成本
- vacuum_cost_page_hit - 在緩衝快取中找到頁面的真空成本
- vacuum_cost_page_miss - 未在緩衝快取中找到頁面的真空成本
- vacuum_defer_cleanup_age - 應延遲 VACUUM 與 HOT 清理的次數(如有)
- vacuum_freeze_min_age - 真空應凍結表格列的最低年齡
- vacuum_freeze_table_age - VACUUM 應掃描整表以凍結元組的年齡
- vacuum_multixact_freeze_min_age - VACUUM 在資料表列中凍結 MultiXactId 的最低時間
- vacuum_multixact_freeze_table_age - 多重 VACUUM 應掃描整個資料表以凍結元組的多重年代
- wal_receiver_status_interval - 設定 WAL 接收器狀態報告至主節點的最大間隔
- wal_writer_delay - WAL 同花之間的間隔時間,在 WAL 寫入器中執行
- wal_writer_flush_after - 由 WAL 寫入者寫入的 WAL 數量,觸發同沖
- work_mem - 設定內部排序操作與雜湊表在寫入暫存磁碟檔案前所使用的記憶體容量
- XMLbinary - 設定二進位值以 XML 編碼的方式
- xmloption - 設定隱含式解析與序列化操作中的 XML 資料應視為文件還是內容片段