本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Aurora PostgreSQL 參考
在下列主題中，您可以找到 Amazon Aurora PostgreSQL 中與定序、函數、參數和等待事件相關的資訊。
**Topics**
+ [適用於 EBCDIC 和其他大型主機遷移的 Aurora PostgreSQL 定序](#AuroraPostgreSQL.Reference.Collations.mainframe.migration)
+ [Aurora PostgreSQL 支援的定序](PostgreSQL-Collations.md)
+ [Aurora PostgreSQL 函數參考](Appendix.AuroraPostgreSQL.Functions.md)
+ [Amazon Aurora PostgreSQL 參數](AuroraPostgreSQL.Reference.ParameterGroups.md)
+ [Amazon Aurora PostgreSQL 等待事件](AuroraPostgreSQL.Reference.Waitevents.md)
## 適用於 EBCDIC 和其他大型主機遷移的 Aurora PostgreSQL 定序
將大型主機應用程式遷移至新平台 (例如 AWS) 理想地保留應用程式行為。若要在新平台上保留應用程式行為與大型主機完全相同，需要使用相同的定序和排序規則對遷移的資料進行整理。例如，許多 Db2 遷移解決方案將空值轉移到 u0180 (Unicode 位置 0180)，因此這些定序首先對 u0180 進行排序。這是定序與其大型主機來源有所不同，以及為何必須選擇能夠更好地對應至原始 EBCDIC 定序的定序規則的範例。
Aurora PostgreSQL 14.3 及更高版本提供許多 ICU 和 EBCDIC 定序，以支援使用 AWS Mainframe Modernization 服務進行到 AWS 的此種遷移。若要進一步了解此服務，請參閱[什麼是 AWSMainframe Modernization？](https://docs.aws.amazon.com/m2/latest/userguide/what-is-m2.html)
您可以在下表中找到 Aurora PostgreSQL - 提供的定序。這些定序遵循 EBCDIC 規則，並確保大型主機應用程式在 AWS 上的功能與大型主機環境中相同。定序名稱包含相關字碼頁，(cp*nnnn*)，以便您可以為您的大型主機來源選擇適當的定序規則。例如，使用 `en-US-cp037-x-icu` 以達到起源於使用字碼頁 037 之大型主機應用程式的 EBCDIC 資料的定序行為。
| EBCDIC 定序 | AWS Blu Age 定序 | AWS Micro Focus 定序 |
| --- | --- | --- |
| da-DK-cp1142-x-icu | da-DK-cp1142b-x-icu | da-DK-cp1142m-x-icu |
| da-DK-cp277-x-icu | da-DK-cp277b-x-icu | – |
| de-DE-cp1141-x-icu | de-DE-cp1141b-x-icu | de-DE-cp1141m-x-icu |
| de-DE-cp273-x-icu | de-DE-cp273b-x-icu | – |
| en-GB-cp1146-x-icu | en-GB-cp1146b-x-icu | en-GB-cp1146m-x-icu |
| en-GB-cp285-x-icu | en-GB-cp285b-x-icu | – |
| en-US-cp037-x-icu | en-US-cp037b-x-icu | – |
| en-US-cp1140-x-icu | en-US-cp1140b-x-icu | en-US-cp1140m-x-icu |
| es-ES-cp1145-x-icu | es-ES-cp1145b-x-icu | es-ES-cp1145m-x-icu |
| es-ES-cp284-x-icu | es-ES-cp284b-x-icu | – |
| fi-FI-cp1143-x-icu | fi-FI-cp1143b-x-icu | fi-FI-cp1143m-x-icu |
| fi-FI-cp278-x-icu | fi-FI-cp278b-x-icu | – |
| fr-FR-cp1147-x-icu | fr-FR-cp1147b-x-icu | fr-FR-cp1147m-x-icu |
| fr-FR-cp297-x-icu | fr-FR-cp297b-x-icu | – |
| it-IT-cp1144-x-icu | it-IT-cp1144b-x-icu | it-IT-cp1144m-x-icu |
| it-IT-cp280-x-icu | it-IT-cp280b-x-icu | – |
| nl-BE-cp1148-x-icu | nl-BE-cp1148b-x-icu | nl-BE-cp1148m-x-icu |
| nl-BE-cp500-x-icu | nl-BE-cp500b-x-icu | – |
若要進一步了解 AWS Blu Age，請參閱 *AWSMainframe Modernization 使用者指南*中的[教學課程：AWS Blu Age 的受管執行階段](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime-ba.html)。
如需使用 AWS Micro Focus 的詳細資訊，請參閱 *AWSMainframe Modernization 使用者指南*中的[教學課程：Micro Focus 的受管執行階段](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html)。
若要進一步了解管理 PostgreSQL 中的定序，請參閱 PostgreSQL 文件中的[定序支援](https://www.postgresql.org/docs/current/collation.html)。
# Aurora PostgreSQL 支援的定序
定序是一組規則，用來決定如何排序和比較存放在資料庫中的字元字串。定序在電腦系統中扮演著基本角色，並包含為作業系統的一部分。隨著新字元加入至語言或排序規則變更時，定序也會變更。
定序程式庫會定義定序的特定規則和演算法。PostgreSQL 內使用的最熱門定序程式庫是 GNU C (glibc)和 Unicode 國際化元件 (ICU)。依預設，Aurora PostgreSQL 會使用 glibc 定序，其中包含多位元組字元序列的 Unicode 字元排序順序。
當您建立新的 Aurora PostgreSQL DB 叢集 時，它會檢查作業系統是否有可用的定序。`CREATE DATABASE` 命令 `LC_COLLATE` 和 `LC_CTYPE` 的 PostgreSQL 參數用來指定一個定序，其作為該資料庫中的預設定序。或者，您也可以使用 `CREATE DATABASE` 中的 `LOCALE` 參數來設定這些參數。這會決定資料庫中字元字串的預設定序，以及將字元分類為字母、數字或符號的規則。您也可以選擇要在資料欄、索引或查詢上使用的定序。
Aurora PostgreSQL 取決於作業系統中的 glibc 程式庫是否支援定序。Aurora PostgreSQL 執行個體會定期使用最新版本的作業系統進行更新。這些更新有時會包含較新版本的 glibc 程式庫。較新版本的 glibc 很少會變更某些字元的排序順序或定序，這可能導致資料以不同的方式排序或產生無效的索引項目。如果您在更新期間發現定序的排序順序問題，您可能需要重建索引。
為了 glibc 更新可能造成的影響，Aurora PostgreSQL 現在包含獨立的預設定序程式庫。此定序程式庫可在 Aurora PostgreSQL 14.6、13.9、12.13、11.18 和較新的次要版本中使用。它與 glibc 2.26-59.amzn2 相容，並提供排序順序穩定性以防止出現不正確的查詢結果。
# Aurora PostgreSQL 函數參考
您可以在下文找到 Aurora PostgreSQL 函數的清單，這些函數適用於執行 Aurora PostgreSQL 相容版本資料庫引擎的 Aurora 資料庫叢集。除了標準 PostgreSQL 函數之外，還有這些 Aurora PostgreSQL 函數。如需標準 PostgreSQL 函數的詳細資訊，請參閱 [PostgreSQL–函數和運算子](https://www.postgresql.org/docs/current/functions.html)。
## 概觀
您可對執行 Aurora PostgreSQL 的 Amazon RDS 資料庫執行個體使用下列函數：
+ [aurora\$1db\$1instance\$1identifier](aurora_db_instance_identifier.md)
+ [aurora\$1ccm\$1status](aurora_ccm_status.md)
+ [aurora\$1global\$1db\$1instance\$1status](aurora_global_db_instance_status.md)
+ [aurora\$1global\$1db\$1status](aurora_global_db_status.md)
+ [aurora\$1list\$1builtins](aurora_list_builtins.md)
+ [aurora\$1replica\$1status](aurora_replica_status.md)
+ [aurora\$1stat\$1activity](aurora_stat_activity.md)
+ [aurora\$1stat\$1backend\$1waits](aurora_stat_backend_waits.md)
+ [aurora\$1stat\$1bgwriter](aurora_stat_bgwriter.md)
+ [aurora\$1stat\$1database](aurora_stat_database.md)
+ [aurora\$1stat\$1dml\$1activity](aurora_stat_dml_activity.md)
+ [aurora\$1stat\$1get\$1db\$1commit\$1latency](aurora_stat_get_db_commit_latency.md)
+ [aurora\$1stat\$1logical\$1wal\$1cache](aurora_stat_logical_wal_cache.md)
+ [aurora\$1stat\$1memctx\$1usage](aurora_stat_memctx_usage.md)
+ [aurora\$1stat\$1optimized\$1reads\$1cache](aurora_stat_optimized_reads_cache.md)
+ [aurora\$1stat\$1plans](aurora_stat_plans.md)
+ [aurora\$1stat\$1reset\$1wal\$1cache](aurora_stat_reset_wal_cache.md)
+ [aurora\$1stat\$1statements](aurora_stat_statements.md)
+ [aurora\$1stat\$1system\$1waits](aurora_stat_system_waits.md)
+ [aurora\$1stat\$1wait\$1event](aurora_stat_wait_event.md)
+ [aurora\$1stat\$1wait\$1type](aurora_stat_wait_type.md)
+ [aurora\$1version](aurora_version.md)
+ [aurora\$1volume\$1logical\$1start\$1lsn](aurora_volume_logical_start_lsn.md)
+ [aurora\$1wait\$1report](aurora_wait_report.md)
# aurora\$1db\$1instance\$1identifier
報告您所連線的資料庫執行個體名稱。
## 語法
```
aurora_db_instance_identifier()
```
## 引數
無
## 傳回類型
VARCHAR 字串
## 使用須知
此函數會顯示 Aurora PostgreSQL 相容版叢集的資料庫執行個體名稱，適用於您的資料庫用戶端或應用程式連線。
此函數從 PostgreSQL 版本 13.7、12.11、11.16、10.21 及所有其他更新的版本開始提供。
## 範例
下列範例顯示呼叫 `aurora_db_instance_identifier` 函數的結果。
```
=> SELECT aurora_db_instance_identifier();
aurora_db_instance_identifier
-------------------------------
test-my-instance-name
```
您可以將此函數的結果與 `aurora_replica_status` 函數聯結，以取得連線資料庫執行個體的詳細資訊。只有 [aurora\$1replica\$1status](aurora_replica_status.md) 並不能提供向您顯示您正在使用的資料庫執行個體。下列範例會顯示作法。
```
=> SELECT *
FROM aurora_replica_status() rt,
aurora_db_instance_identifier() di
WHERE rt.server_id = di;
-[ RECORD 1 ]----------------------+-----------------------
server_id | test-my-instance-name
session_id | MASTER_SESSION_ID
durable_lsn | 88492069
highest_lsn_rcvd |
current_read_lsn |
cur_replay_latency_in_usec |
active_txns |
is_current | t
last_transport_error | 0
last_error_timestamp |
last_update_timestamp | 2022-06-03 11:18:25+00
feedback_xmin |
feedback_epoch |
replica_lag_in_msec |
log_stream_speed_in_kib_per_second | 0
log_buffer_sequence_number | 0
oldest_read_view_trx_id |
oldest_read_view_lsn |
pending_read_ios | 819
```
# aurora\$1ccm\$1status
顯示叢集快取管理員的狀態。
## 語法
```
aurora_ccm_status()
```
## 引數
無。
## 傳回類型
SETOF 記錄，包含下列欄：
+ `buffers_sent_last_minute` – 過去一分鐘內傳送至指定讀取器的緩衝區數量。
+ `buffers_found_last_minute` – 過去一分鐘內識別出頻繁存取緩衝區的數量。
+ `buffers_sent_last_scan` – 於緩衝區快取的最後一次完整掃描期間傳送至指定讀取器的緩衝區數量。
+ `buffers_found_last_scan` – 於緩衝區快取的最後一次完整掃描期間傳送的頻繁存取緩衝區數量。已在指定讀取器上快取的緩衝區未傳送。
+ `buffers_sent_current_scan` – 於目前掃描期間傳送的緩衝區數量。
+ `buffers_found_current_scan` – 於目前掃描中識別之頻繁存取緩衝區的數量。
+ `current_scan_progress` – 於目前掃描期間至現在為止所造訪的緩衝區數量。
## 使用須知
您可使用此功能來檢查和監控叢集快取管理 (CCM) 功能。此函數僅適用於 CCM 在 Aurora PostgreSQL 資料庫叢集上為作用中時。如要使用此函數，請連線至 Aurora PostgreSQL 資料庫叢集上的寫入資料庫執行個體。
您可於叢集的自訂資料庫叢集參數群組中將 `apg_ccm_enabled` 設定為 1，為 Aurora PostgreSQL 資料庫叢集開啟 CCM。如要瞭解如何作業，請參閱[設定叢集快取管理](AuroraPostgreSQL.cluster-cache-mgmt.md#AuroraPostgreSQL.cluster-cache-mgmt.Configure)。
當叢集具有 Aurora 讀取器執行個體設定如下時，叢集快取管理在 Aurora PostgreSQL 資料庫叢集為作用中狀態：
+ Aurora 讀取器執行個體會使用與叢集寫入器執行個體相同的資料庫執行個體類別類型和大小。
+ Aurora 讀取器執行個體會設定為叢集的第 0 層。若叢集具有多個讀取器，則此為其唯一的第 0 層讀取器。
將多個讀取器設定為第 0 層將會停用 CCM。停用 CCM 時，呼叫此函數會回傳下列錯誤訊息：
```
ERROR: Cluster Cache Manager is disabled
```
您還可使用 PostgreSQL Pg\$1Buffercache 擴充功能來分析緩衝區快取。如需詳細資訊，請參閱 PostgreSQL 文件中的 [pg\$1buffercache](https://www.postgresql.org/docs/current/pgbuffercache.html)。
如需詳細資訊，請參閱 [Introduction to Aurora PostgreSQL cluster cache management](https://aws.amazon.com/blogs/database/introduction-to-aurora-postgresql-cluster-cache-management/) (Aurora PostgreSQL 叢集快取管理簡介)。
## 範例
下列範例顯示呼叫 `aurora_ccm_status` 函數的結果。第一個範例顯示 CCM 統計資料。
```
=> SELECT * FROM aurora_ccm_status();
buffers_sent_last_minute | buffers_found_last_minute | buffers_sent_last_scan | buffers_found_last_scan | buffers_sent_current_scan | buffers_found_current_scan | current_scan_progress
--------------------------+---------------------------+------------------------+-------------------------+---------------------------+----------------------------+-----------------------
2242000 | 2242003 | 17920442 | 17923410 | 14098000 | 14100964 | 15877443
```
如需更多完整的詳細資訊，您可使用展開顯示，如下所示：
```
\x
Expanded display is on.
SELECT * FROM aurora_ccm_status();
[ RECORD 1 ]-----------------------+---------
buffers_sent_last_minute | 2242000
buffers_found_last_minute | 2242003
buffers_sent_last_scan | 17920442
buffers_found_last_scan | 17923410
buffers_sent_current_scan | 14098000
buffers_found_current_scan | 14100964
current_scan_progress | 15877443
```
此範例說明如何檢查暖率和暖百分比。
```
=> SELECT buffers_sent_last_minute * 8/60 AS warm_rate_kbps,
100 * (1.0-buffers_sent_last_scan/buffers_found_last_scan) AS warm_percent
FROM aurora_ccm_status ();
warm_rate_kbps | warm_percent
----------------+--------------
16523 | 100.0
```
# aurora\$1global\$1db\$1instance\$1status
顯示所有 Aurora 執行個體的狀態，包括 Aurora 全域資料庫叢集中的複本。
## 語法
```
aurora_global_db_instance_status()
```
## 引數
無
## 傳回類型
SETOF 記錄，包含下列欄：
+ `server_id` – 資料庫執行個體的識別符。
+ `session_id` – 目前工作階段的唯一識別符。`MASTER_SESSION_ID` 值可識別寫入器 (主) 資料庫執行個體。
+ `aws_region` – 此全域資料庫執行個體執行所在的 AWS 區域。如需區域清單，請參閱 [區域可用性](Concepts.RegionsAndAvailabilityZones.md#Aurora.Overview.Availability)。
+ `durable_lsn` – 可長期儲存的日誌序號 (LSN)。記錄序號 (LSN) 是一組獨特的序號，可用來識別資料庫交易日誌中的記錄。系統會排序 LSN，而 LSN 越大，就表示交易發生時間越後面。
+ `highest_lsn_rcvd` – 資料庫執行個體從寫入器資料庫執行個體接收的最高 LSN。
+ `feedback_epoch` – 資料庫執行個體產生熱待命資訊時所使用的 epoch。*熱待命*是主資料庫處於復原或待命模式時支援連線和查詢的資料庫執行個體。熱待命資訊包括 epoch (時間點) 及有關用來作為熱待命資料庫執行個體的其他詳細資料。如需詳細資訊，請參閱 PostgreSQL 文件中的 [Hot standby (熱待命)](https://www.postgresql.org/docs/current/hot-standby.html)。
+ `feedback_xmin` – 資料庫執行個體所使用的最小 (最舊) 作用中交易 ID。
+ `oldest_read_view_lsn` – 資料庫執行個體從儲存體中讀取資料時所使用的最舊 LSN。
+ `visibility_lag_in_msec` – 此資料庫執行個體落後於寫入器資料庫執行個體的時間 (以毫秒為單位)。
## 使用須知
此函數會顯示 Aurora 資料庫叢集的複寫統計資料。對於叢集中的每個 Aurora PostgreSQL 資料庫執行個體，此函數會顯示一列資料，其中包括全域資料庫組態中的任何跨區域複本。
您可從 Aurora PostgreSQL 資料庫叢集或 Aurora PostgreSQL 全域資料庫中的任何執行個體執行此函數。該函數會回傳所有複本執行個體的延遲相關詳細資料。
若要進一步了解使用此函數 (`aurora_global_db_instance_status`) 或使用 `aurora_global_db_status` 監控延遲的相關資訊，請參閱 [監控 Aurora PostgreSQL 型全球資料庫](aurora-global-database-monitoring.md#aurora-global-database-monitoring.postgres)。
如需更多 Aurora 全域資料庫的詳細資訊，請參閱 [Amazon Aurora 全球資料庫的概觀](aurora-global-database.md#aurora-global-database-overview)。
若要開始使用 Aurora 全域資料庫，請參閱 [Amazon Aurora 全球資料庫入門](aurora-global-database-getting-started.md)，或請參閱 [Amazon Aurora 常見問答集](https://aws.amazon.com/rds/aurora/faqs/)。
## 範例
此範例示範跨區域執行個體統計資料。
```
=> SELECT *
FROM aurora_global_db_instance_status();
server_id | session_id | aws_region | durable_lsn | highest_lsn_rcvd | feedback_epoch | feedback_xmin | oldest_read_view_lsn | visibility_lag_in_msec
------------------------------------------+--------------------------------------+--------------+-------------+------------------+----------------+---------------+----------------------+------------------------
db-119-001-instance-01 | MASTER_SESSION_ID | eu-west-1 | 2534560273 | [NULL] | [NULL] | [NULL] | [NULL] | [NULL]
db-119-001-instance-02 | 4ecff34d-d57c-409c-ba28-278b31d6fc40 | eu-west-1 | 2534560266 | 2534560273 | 0 | 19669196 | 2534560266 | 6
db-119-001-instance-03 | 3e8a20fc-be86-43d5-95e5-bdf19d27ad6b | eu-west-1 | 2534560266 | 2534560273 | 0 | 19669196 | 2534560266 | 6
db-119-001-instance-04 | fc1b0023-e8b4-4361-bede-2a7e926cead6 | eu-west-1 | 2534560266 | 2534560273 | 0 | 19669196 | 2534560254 | 23
db-119-001-instance-05 | 30319b74-3f08-4e13-9728-e02aa1aa8649 | eu-west-1 | 2534560266 | 2534560273 | 0 | 19669196 | 2534560254 | 23
db-119-001-global-instance-1 | a331ffbb-d982-49ba-8973-527c96329c60 | eu-central-1 | 2534560254 | 2534560266 | 0 | 19669196 | 2534560247 | 996
db-119-001-global-instance-1 | e0955367-7082-43c4-b4db-70674064a9da | eu-west-2 | 2534560254 | 2534560266 | 0 | 19669196 | 2534560247 | 14
db-119-001-global-instance-1-eu-west-2a | 1248dc12-d3a4-46f5-a9e2-85850491a897 | eu-west-2 | 2534560254 | 2534560266 | 0 | 19669196 | 2534560247 | 0
```
此範例示範如何檢查全域複本延遲 (以毫秒為單位)。
```
=> SELECT CASE
WHEN 'MASTER_SESSION_ID' = session_id THEN 'Primary'
ELSE 'Secondary'
END AS global_role,
aws_region,
server_id,
visibility_lag_in_msec
FROM aurora_global_db_instance_status()
ORDER BY 1, 2, 3;
global_role | aws_region | server_id | visibility_lag_in_msec
-------------+--------------+-----------------------------------------+------------------------
Primary | eu-west-1 | db-119-001-instance-01 | [NULL]
Secondary | eu-central-1 | db-119-001-global-instance-1 | 13
Secondary | eu-west-1 | db-119-001-instance-02 | 10
Secondary | eu-west-1 | db-119-001-instance-03 | 9
Secondary | eu-west-1 | db-119-001-instance-04 | 2
Secondary | eu-west-1 | db-119-001-instance-05 | 18
Secondary | eu-west-2 | db-119-001-global-instance-1 | 14
Secondary | eu-west-2 | db-119-001-global-instance-1-eu-west-2a | 13
```
此範例示範如何從全域資料庫組態檢查每個 AWS 區域 的最小、最大，及平均延遲。
```
=> SELECT 'Secondary' global_role,
aws_region,
min(visibility_lag_in_msec) min_lag_in_msec,
max(visibility_lag_in_msec) max_lag_in_msec,
round(avg(visibility_lag_in_msec),0) avg_lag_in_msec
FROM aurora_global_db_instance_status()
WHERE aws_region NOT IN (SELECT aws_region
FROM aurora_global_db_instance_status()
WHERE session_id='MASTER_SESSION_ID')
GROUP BY aws_region
UNION ALL
SELECT 'Primary' global_role,
aws_region,
NULL,
NULL,
NULL
FROM aurora_global_db_instance_status()
WHERE session_id='MASTER_SESSION_ID'
ORDER BY 1, 5;
global_role | aws_region | min_lag_in_msec | max_lag_in_msec | avg_lag_in_msec
------------+--------------+-----------------+-----------------+-----------------
Primary | eu-west-1 | [NULL] | [NULL] | [NULL]
Secondary | eu-central-1 | 133 | 133 | 133
Secondary | eu-west-2 | 0 | 495 | 248
```
# aurora\$1global\$1db\$1status
顯示有關 Aurora 全域資料庫延遲各方面的資訊，特別是基礎 Aurora 儲存的延遲 (稱為持久性延遲) 及復原點目標 (RPO) 之間的延遲。
## 語法
```
aurora_global_db_status()
```
## 引數
無。
## 傳回類型
SETOF 記錄，包含下列欄：
+ `aws_region` – 此資料庫叢集所在的 AWS 區域。如需依引擎列出的 AWS 區域 完整清單，請參閱 [區域和可用區域](Concepts.RegionsAndAvailabilityZones.md)。
+ `highest_lsn_written` – 目前存在於此資料庫叢集上的最高日誌序號 (LSN)。記錄序號 (LSN) 是一組獨特的序號，可用來識別資料庫交易日誌中的記錄。系統會排序 LSN，而 LSN 越大，就表示交易發生時間越後面。
+ `durability_lag_in_msec` – 次要資料庫叢集上的 `highest_lsn_written` 與主資料庫叢集上的 `highest_lsn_written` 之間的時間戳記值差異。值 -1 識別 Aurora 全域資料庫的主要資料庫叢集。
+ `rpo_lag_in_msec` – 復原點目標 (RPO) 延遲。RPO 延遲是指最近使用者交易 COMMIT 在儲存於 Aurora 全域資料庫的主資料庫叢集之後，將其儲存於次要資料庫叢集上所需的時間。值 -1 表示主要資料庫叢集 (因此沒有延遲的問題)。
簡言之，此指標會計算 Aurora 全域資料庫中每個 Aurora PostgreSQL 資料庫叢集的復原點目標，亦即，若有中斷發生，可能會遺失的資料量。與延遲一樣，RPO 是以時間來衡量。
+ `last_lag_calculation_time` – 指出上次為 `durability_lag_in_msec` 和 `rpo_lag_in_msec` 計算值的時間戳記。例如 `1970-01-01 00:00:00+00` 之類的時間值表示此為主要資料庫叢集。
+ `feedback_epoch` – 次要資料庫叢集產生熱待命資訊時所使用的 epoch。*熱待命*是主資料庫為復原或待命模式時支援連線和查詢的資料庫執行個體。熱待命資訊包括 epoch (時間點) 及有關用來作為熱待命資料庫執行個體的其他詳細資料。如需詳細資訊，請參閱 PostgreSQL 文件中的 [Hot standby (熱待命)](https://www.postgresql.org/docs/current/hot-standby.html)。
+ `feedback_xmin` – 次要資料庫叢集所使用的最小 (最舊) 作用中交易 ID。
## 使用須知
所有目前可用的 Aurora PostgreSQL 版本都支援此功能。此函數會顯示 Aurora 全域資料庫的複寫統計資料。Aurora PostgreSQL 全域資料庫中每個資料庫叢集會各自顯示為一列。您可從 Aurora PostgreSQL 全域資料庫中的任何執行個體執行此函數。
如要評估 Aurora 全域資料庫複製延遲 (此為可見的資料延遲)，請參閱 [aurora\$1global\$1db\$1instance\$1status](aurora_global_db_instance_status.md)。
若要進一步了解使用 `aurora_global_db_status` 和 `aurora_global_db_instance_status` 來監控 Aurora 全域資料庫延遲，請參閱 [監控 Aurora PostgreSQL 型全球資料庫](aurora-global-database-monitoring.md#aurora-global-database-monitoring.postgres)。如需更多 Aurora 全域資料庫的詳細資訊，請參閱 [Amazon Aurora 全球資料庫的概觀](aurora-global-database.md#aurora-global-database-overview)。
## 範例
此範例示範如何顯示跨區域儲存統計資料。
```
=> SELECT CASE
WHEN '-1' = durability_lag_in_msec THEN 'Primary'
ELSE 'Secondary'
END AS global_role,
*
FROM aurora_global_db_status();
global_role | aws_region | highest_lsn_written | durability_lag_in_msec | rpo_lag_in_msec | last_lag_calculation_time | feedback_epoch | feedback_xmin
-------------+------------+---------------------+------------------------+-----------------+----------------------------+----------------+---------------
Primary | eu-west-1 | 131031557 | -1 | -1 | 1970-01-01 00:00:00+00 | 0 | 0
Secondary | eu-west-2 | 131031554 | 410 | 0 | 2021-06-01 18:59:36.124+00 | 0 | 12640
Secondary | eu-west-3 | 131031554 | 410 | 0 | 2021-06-01 18:59:36.124+00 | 0 | 12640
```
# aurora\$1list\$1builtins
列出所有可用的 Aurora PostgreSQL 內建函數，以及簡要說明和函數詳細資訊。
## 語法
```
aurora_list_builtins()
```
## 引數
無
## 傳回類型
SETOF 記錄
## 範例
下列範例會顯示呼叫 `aurora_list_builtins` 函數的結果。
```
=> SELECT *
FROM aurora_list_builtins();
Name | Result data type | Argument data types | Type | Volatility | Parallel | Security | Description
-----------------------------------+------------------+----------------------------------------------------------+------+------------+------------+----------+---------------------------------------------------------------------
aurora_version | text | | func | stable | safe | invoker | Amazon Aurora PostgreSQL-Compatible Edition version string
aurora_stat_wait_type | SETOF record | OUT type_id smallint, OUT type_name text | func | volatile | restricted | invoker | Lists all supported wait types
aurora_stat_wait_event | SETOF record | OUT type_id smallint, OUT event_id integer, OUT event_na.| func | volatile | restricted | invoker | Lists all supported wait events
| |.me text | | | | |
aurora_list_builtins | SETOF record | OUT "Name" text, OUT "Result data type" text, OUT "Argum.| func | stable | safe | invoker | Lists all Aurora built-in functions
| |.ent data types" text, OUT "Type" text, OUT "Volatility" .| | | | |
| |.text, OUT "Parallel" text, OUT "Security" text, OUT "Des.| | | | |
| |.cription" text | | | | |
.
.
.
aurora_stat_file | SETOF record | OUT filename text, OUT allocated_bytes bigint, OUT used_.| func | stable | safe | invoker | Lists all files present in Aurora storage
| |.bytes bigint | | | | |
aurora_stat_get_db_commit_latency | bigint | oid | func | stable | restricted | invoker | Per DB commit latency in microsecs
```
# aurora\$1replica\$1status
顯示所有 Aurora PostgreSQL 讀取器節點的狀態。
## 語法
```
aurora_replica_status()
```
## 引數
無
## 傳回類型
SETOF 記錄，包含下列欄：
+ `server_id` – 資料庫執行個體 ID (識別符)。
+ `session_id` – 目前工作階段的唯一識別符，如下所示，為主要執行個體和讀取器執行個體傳回：
+ 若為主要執行個體，`session_id` 一律為 ``MASTER_SESSION_ID’`。
+ 若為讀取器執行個體，`session_id` 一律為讀取器執行個體的 `UUID` (通用唯一識別符)。
+ `durable_lsn` – 已儲存於儲存體中的日誌序號 (LSN)。
+ 若為主磁碟區，目前作用中的主磁碟區耐用性 LSN (VDL)。
+ 若為任何次要磁碟區，次要已成功套用至之主要的 VDL。
**注意**
記錄序號 (LSN) 是一組獨特的序號，可用來識別資料庫交易日誌中的記錄。LSN 依順序排列，LSN 越大，就表示交易發生時間越後面。
+ `highest_lsn_rcvd` – 資料庫執行個體從寫入器資料庫執行個體接收的最高 (最新) LSN。
+ `current_read_lsn` – 套用至所有讀取器之最新快照的 LSN。
+ `cur_replay_latency_in_usec` – 預期在次要設備上重播日誌所需的微秒數。
+ `active_txns` – 目前作用中交易的數目。
+ `is_current` – 未使用。
+ `last_transport_error` – 上次複寫錯誤代碼。
+ `last_error_timestamp` – 上次複寫錯誤的時間戳記。
+ `last_update_timestamp` – 上次更新複本狀態的時間戳記。從 Aurora PostgreSQL 13.9 開始，您連線的資料庫執行個體的 `last_update_timestamp` 值會設定為 `NULL`。
+ `feedback_xmin` – 複本的熱待命 feedback\$1xmin。資料庫執行個體所使用的最小 (最舊) 作用中交易 ID。
+ `feedback_epoch` – 資料庫執行個體產生熱待命資訊時所使用的 epoch。
+ `replica_lag_in_msec`：讀取器執行個體延遲於執行個體的時間 (以毫秒為單位)。
+ `log_stream_speed_in_kib_per_second` – 日誌串流輸送量 (以 KB/秒為單位)。
+ `log_buffer_sequence_number` – 日誌緩衝區序列號。
+ `oldest_read_view_trx_id` – 未使用。
+ `oldest_read_view_lsn` – 資料庫執行個體從儲存體中讀取資料時所使用的最舊 LSN。
+ `pending_read_ios` – 複本上仍處於待命狀態的未完成頁面讀取。
+ `read_ios` – 複本上的頁面讀取總數。
+ `iops` – 未使用。
+ `cpu`：叢集中每個節點的 Aurora 儲存常駐程式 CPU 用量。如需有關執行個體 CPU 用量的資訊，請參閱 [Amazon Aurora 的執行個體層級指標](Aurora.AuroraMonitoring.Metrics.md#Aurora.AuroraMySQL.Monitoring.Metrics.instances)。
## 使用須知
所有目前可用的 Aurora PostgreSQL 版本都支援此功能。`aurora_replica_status` 函數會從 Aurora PostgreSQL 資料庫叢集的複本狀態管理器傳回值。您可使用此函數以獲取有關 Aurora PostgreSQL 資料庫叢集上複寫狀態的資訊，包括 Aurora 資料庫叢集中所有資料庫執行個體的指標。例如，您可以執行下列動作：
+ **取得有關 Aurora PostgreSQL 資料庫叢集中執行個體類型 (寫入器、讀取器) 的資訊** – 您可檢查下列欄的值以取得此資訊：
+ `server_id` – 包含您在建立執行個體時指定的執行個體名稱。在某些情況下，例如對於主 (寫入器) 執行個體，該名稱通常是將 *-instance-1* 附加至您為 Aurora PostgreSQL 資料庫叢集建立的名稱來建立的。
+ `session_id` – `session_id` 欄位指出執行個體是讀取器還是寫入器。若為寫入器執行個體，`session_id` 一律設定為 `"MASTER_SESSION_ID"`。若為讀取器執行個體，`session_id` 設定為特定讀取器的 `UUID`。
+ **診斷常見複寫問題，如複本延遲** - 複本延遲是讀取器執行個體頁面快取落後於寫入器執行個體頁面快取的時間 (以毫秒為單位)。出現此延遲的原因是 Aurora 叢集使用非同步複寫，如 [以 Amazon Aurora 進行複寫](Aurora.Replication.md) 所述。其顯示於此函數傳回結果中的 `replica_lag_in_msec` 欄中。由於與備用伺服器上的復原衝突而取消查詢時，也可能會發生延遲。您可檢查 `pg_stat_database_conflicts()`，以驗證此類衝突是否造成複本延遲。如需相關資訊，請參閱 *PostgreSQL 文件*中的[統計數字收集器](https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-PG-STAT-DATABASE-CONFLICTS-VIEW)。如要進一步了解有關高可用性和複寫的資訊，請參 [Amazon Aurora 常見問答集](https://aws.amazon.com/rds/aurora/faqs/#High_Availability_and_Replication)。
Amazon CloudWatch 隨時間將 `replica_lag_in_msec` 結果儲存為 `AuroraReplicaLag` 指標。如需使用 Aurora 的 CloudWatch 指標相關資訊，請參閱 [使用 Amazon CloudWatch 監控 Amazon Aurora 指標](monitoring-cloudwatch.md)。
若要進一步了解 Aurora 僅供讀取複本和重新啟動的疑難排解相關資訊，請參閱 [AWS 支援 中心](https://console.aws.amazon.com/support/home#/)中的[為什麼我的 Amazon Aurora 僅供讀取複本落後且重新啟動？](https://aws.amazon.com/premiumsupport/knowledge-center/aurora-read-replica-restart/)。
## 範例
下列範例顯示如何獲取 Aurora PostgreSQL 資料庫叢集中所有執行個體的複寫狀態：
```
=> SELECT *
FROM aurora_replica_status();
```
下列範例顯示 `docs-lab-apg-main` Aurora PostgreSQL 資料庫叢集中的寫入器執行個體：
```
=> SELECT server_id,
CASE
WHEN 'MASTER_SESSION_ID' = session_id THEN 'writer'
ELSE 'reader'
END AS instance_role
FROM aurora_replica_status()
WHERE session_id = 'MASTER_SESSION_ID';
server_id | instance_role
------------------------+---------------
db-119-001-instance-01 | writer
```
下列範例會列出叢集中的所有讀取器執行個體：
```
=> SELECT server_id,
CASE
WHEN 'MASTER_SESSION_ID' = session_id THEN 'writer'
ELSE 'reader'
END AS instance_role
FROM aurora_replica_status()
WHERE session_id <> 'MASTER_SESSION_ID';
server_id | instance_role
------------------------+---------------
db-119-001-instance-02 | reader
db-119-001-instance-03 | reader
db-119-001-instance-04 | reader
db-119-001-instance-05 | reader
(4 rows)
```
下列範例列出了所有執行個體、每個執行個體落後於寫入器的延遲距離，及自上次更新以來的時間：
```
=> SELECT server_id,
CASE
WHEN 'MASTER_SESSION_ID' = session_id THEN 'writer'
ELSE 'reader'
END AS instance_role,
replica_lag_in_msec AS replica_lag_ms,
round(extract (epoch FROM (SELECT age(clock_timestamp(), last_update_timestamp))) * 1000) AS last_update_age_ms
FROM aurora_replica_status()
ORDER BY replica_lag_in_msec NULLS FIRST;
server_id | instance_role | replica_lag_ms | last_update_age_ms
------------------------+---------------+----------------+--------------------
db-124-001-instance-03 | writer | [NULL] | 1756
db-124-001-instance-01 | reader | 13 | 1756
db-124-001-instance-02 | reader | 13 | 1756
(3 rows)
```
# aurora\$1stat\$1activity
傳回每個伺服器程序的一列，顯示該程序目前活動相關的資訊。
## 語法
```
aurora_stat_activity();
```
## 引數
無
## 傳回類型
每個伺服器程序傳回一列。除了 `pg_stat_activity` 欄之外，還會新增下列欄位：
+ planid：計劃識別符
## 使用須知
`pg_stat_activity` 用來傳回相同欄的補充檢視，其中包含附加 `plan_id` 欄，此欄會顯示目前的查詢執行計劃。
必須啟用 `aurora_compute_plan_id`，檢視才能傳回 plan\$1id。
您可從 Aurora PostgreSQL 版本 14.10、15.5 及所有其他更新的版本使用此函數。
## 範例
以下查詢範例會依 query\$1id 和 plan\$1id 彙總最高負載。
```
db1=# select count(*), query_id, plan_id
db1-# from aurora_stat_activity() where state = 'active'
db1-# and pid <> pg_backend_pid()
db1-# group by query_id, plan_id
db1-# order by 1 desc;
count | query_id | plan_id
-------+----------------------+-------------
11 | -5471422286312252535 | -2054628807
3 | -6907107586630739258 | -815866029
1 | 5213711845501580017 | 300482084
(3 rows)
```
如果用於 query\$1id 的計劃有所變更，則 aurora\$1stat\$1activity 將報告新的 plan\$1id。
```
count | query_id | plan_id
-------+----------------------+-------------
10 | -5471422286312252535 | 1602979607
1 | -6907107586630739258 | -1809935983
1 | -2446282393000597155 | -207532066
(3 rows)
```
# aurora\$1stat\$1backend\$1waits
顯示特定後端程序的等待活動統計資料。
## 語法
```
aurora_stat_backend_waits(pid)
```
## 引數
`pid` – 後端程序的 ID。您可使用 `pg_stat_activity` 檢視取得程序 ID。
## 傳回類型
SETOF 記錄，包含下列欄：
+ `type_id` – 表示等待事件類型的數字，例如，`1` 表示輕量型鎖定 (`LWLock`)，`3` 表示鎖定，或 `6` 表示用戶端工作階段。當您將此函數的結果與 `aurora_stat_wait_type` 函數的欄聯結時，這些值會變得有意義，如 [範例](#aurora_stat_backend_waits-examples) 中所示。
+ `event_id` – 等待事件的識別號碼。將此值與 `aurora_stat_wait_event` 中的欄聯結，以取得有意義的事件名稱。
+ `waits` – 指定程序 ID 的累積等待數目。
+ `wait_time` – 等待時間 (以毫秒為單位)。
## 使用須知
您可使用此函數分析自連線開啟後發生的特定後端 (工作階段) 等待事件。如要取得有關等待事件名稱和類型更有意義的資訊，您可以使用範例中所示的 JOIN，結合此函數 `aurora_stat_wait_type` 和 `aurora_stat_wait_event`。
## 範例
此範例會示範後端程序 ID 3027 的所有等待、類型和事件名稱。
```
=> SELECT type_name, event_name, waits, wait_time
FROM aurora_stat_backend_waits(3027)
NATURAL JOIN aurora_stat_wait_type()
NATURAL JOIN aurora_stat_wait_event();
type_name | event_name | waits | wait_time
-----------+------------------------+-------+------------
LWLock | ProcArrayLock | 3 | 27
LWLock | wal_insert | 423 | 16336
LWLock | buffer_content | 11840 | 1033634
LWLock | lock_manager | 23821 | 5664506
Lock | tuple | 10258 | 152280165
Lock | transactionid | 78340 | 1239808783
Client | ClientRead | 34072 | 17616684
IO | ControlFileSyncUpdate | 2 | 0
IO | ControlFileWriteUpdate | 4 | 32
IO | RelationMapRead | 2 | 795
IO | WALWrite | 36666 | 98623
IO | XactSync | 4867 | 7331963
```
此範例會示範所有作用中工作階段 (`pg_stat_activity state <> 'idle'`) 目前及累積等待類型和等待事件 (但並無叫用函數 (`pid <> pg_backend_pid()`) 的目前工作階段。
```
=> SELECT a.pid,
a.usename,
a.app_name,
a.current_wait_type,
a.current_wait_event,
a.current_state,
wt.type_name AS wait_type,
we.event_name AS wait_event,
a.waits,
a.wait_time
FROM (SELECT pid,
usename,
left(application_name,16) AS app_name,
coalesce(wait_event_type,'CPU') AS current_wait_type,
coalesce(wait_event,'CPU') AS current_wait_event,
state AS current_state,
(aurora_stat_backend_waits(pid)).*
FROM pg_stat_activity
WHERE pid <> pg_backend_pid()
AND state <> 'idle') a
NATURAL JOIN aurora_stat_wait_type() wt
NATURAL JOIN aurora_stat_wait_event() we;
pid | usename | app_name | current_wait_type | current_wait_event | current_state | wait_type | wait_event | waits | wait_time
-------+----------+----------+-------------------+--------------------+---------------+-----------+------------------------+-------+-----------
30099 | postgres | pgbench | Lock | transactionid | active | LWLock | wal_insert | 1937 | 29975
30099 | postgres | pgbench | Lock | transactionid | active | LWLock | buffer_content | 22903 | 760498
30099 | postgres | pgbench | Lock | transactionid | active | LWLock | lock_manager | 10012 | 223207
30099 | postgres | pgbench | Lock | transactionid | active | Lock | tuple | 20315 | 63081529
.
.
.
30099 | postgres | pgbench | Lock | transactionid | active | IO | WALWrite | 93293 | 237440
30099 | postgres | pgbench | Lock | transactionid | active | IO | XactSync | 13010 | 19525143
30100 | postgres | pgbench | Lock | transactionid | active | LWLock | ProcArrayLock | 6 | 53
30100 | postgres | pgbench | Lock | transactionid | active | LWLock | wal_insert | 1913 | 25450
30100 | postgres | pgbench | Lock | transactionid | active | LWLock | buffer_content | 22874 | 778005
.
.
.
30109 | postgres | pgbench | IO | XactSync | active | LWLock | ProcArrayLock | 3 | 71
30109 | postgres | pgbench | IO | XactSync | active | LWLock | wal_insert | 1940 | 27741
30109 | postgres | pgbench | IO | XactSync | active | LWLock | buffer_content | 22962 | 776352
30109 | postgres | pgbench | IO | XactSync | active | LWLock | lock_manager | 9879 | 218826
30109 | postgres | pgbench | IO | XactSync | active | Lock | tuple | 20401 | 63581306
30109 | postgres | pgbench | IO | XactSync | active | Lock | transactionid | 50769 | 211645008
30109 | postgres | pgbench | IO | XactSync | active | Client | ClientRead | 89901 | 44192439
```
此範例會示範所有作用中工作階段 (`pg_stat_activity state <> 'idle'`) 目前及前三 (3) 個累積等待類型和等待事件，目前工作階段 (`pid <>pg_backend_pid()`) 除外。
```
=> SELECT top3.*
FROM (SELECT a.pid,
a.usename,
a.app_name,
a.current_wait_type,
a.current_wait_event,
a.current_state,
wt.type_name AS wait_type,
we.event_name AS wait_event,
a.waits,
a.wait_time,
RANK() OVER (PARTITION BY pid ORDER BY a.wait_time DESC)
FROM (SELECT pid,
usename,
left(application_name,16) AS app_name,
coalesce(wait_event_type,'CPU') AS current_wait_type,
coalesce(wait_event,'CPU') AS current_wait_event,
state AS current_state,
(aurora_stat_backend_waits(pid)).*
FROM pg_stat_activity
WHERE pid <> pg_backend_pid()
AND state <> 'idle') a
NATURAL JOIN aurora_stat_wait_type() wt
NATURAL JOIN aurora_stat_wait_event() we) top3
WHERE RANK <=3;
pid | usename | app_name | current_wait_type | current_wait_event | current_state | wait_type | wait_event | waits | wait_time | rank
-------+----------+----------+-------------------+--------------------+---------------+-----------+-----------------+---------+------------+------
20567 | postgres | psql | CPU | CPU | active | LWLock | wal_insert | 25000 | 67512003 | 1
20567 | postgres | psql | CPU | CPU | active | IO | WALWrite | 3071758 | 1016961 | 2
20567 | postgres | psql | CPU | CPU | active | IO | BufFileWrite | 20750 | 184559 | 3
27743 | postgres | pgbench | Lock | transactionid | active | Lock | transactionid | 237350 | 1265580011 | 1
27743 | postgres | pgbench | Lock | transactionid | active | Lock | tuple | 93641 | 341472318 | 2
27743 | postgres | pgbench | Lock | transactionid | active | Client | ClientRead | 417556 | 204796837 | 3
.
.
.
27745 | postgres | pgbench | IO | XactSync | active | Lock | transactionid | 238068 | 1265816822 | 1
27745 | postgres | pgbench | IO | XactSync | active | Lock | tuple | 93210 | 338312247 | 2
27745 | postgres | pgbench | IO | XactSync | active | Client | ClientRead | 419157 | 207836533 | 3
27746 | postgres | pgbench | Lock | transactionid | active | Lock | transactionid | 237621 | 1264528811 | 1
27746 | postgres | pgbench | Lock | transactionid | active | Lock | tuple | 93563 | 339799310 | 2
27746 | postgres | pgbench | Lock | transactionid | active | Client | ClientRead | 417304 | 208372727 | 3
```
# aurora\$1stat\$1bgwriter
`aurora_stat_bgwriter` 是顯示有關 Optimized Reads 快取寫入資訊的統計資料檢視
## 語法
```
aurora_stat_bgwriter()
```
## 引數
無
## 傳回類型
SETOF 記錄包含所有 `pg_stat_bgwriter` 欄和以下附加欄。如需 `pg_stat_bgwriter` 欄的詳細資訊，請參閱 [https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-PG-STAT-BGWRITER-VIEW](https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-PG-STAT-BGWRITER-VIEW)。
您可以使用 `pg_stat_reset_shared("bgwriter")` 重設此函數的統計資料。
+ `orcache_blks_written` - 寫入的最佳化讀取快取資料區塊總數。
+ `orcache_blk_write_time` - 如果啟用 `track_io_timing`，它會追蹤寫入最佳化讀取快取資料檔案區塊所花費的總時間，以毫秒為單位。如需詳細資訊，請參閱 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
## 使用須知
此函數適用於下列 Aurora PostgreSQL 版本：
+ 15.4 版和更新的 15 版本
+ 14.9 版和更新的 14 版本
## 範例
```
=> select * from aurora_stat_bgwriter();
-[ RECORD 1 ]-----------------+-----------
orcache_blks_written | 246522
orcache_blk_write_time | 339276.404
```
# aurora\$1stat\$1database
它攜帶 pg\$1stat\$1database 的所有欄，並在結尾加上新欄。
## 語法
```
aurora_stat_database()
```
## 引數
無
## 傳回類型
SETOF 記錄包含所有 `pg_stat_database` 欄和以下附加欄。如需 `pg_stat_database` 欄的詳細資訊，請參閱 [https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-PG-STAT-DATABASE-VIEW](https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-PG-STAT-DATABASE-VIEW)。
+ `storage_blks_read` - 從此資料庫中 Aurora 儲存體讀取的共用區塊總數。
+ `orcache_blks_hit` - 此資料庫中最佳化讀取快取命中的總數。
+ `local_blks_read` - 在此資料庫中讀取的本機區塊總數。
+ `storage_blk_read_time` - 如果啟用 `track_io_timing`，它會追蹤從 Aurora 儲存讀取資料檔案區塊所花費的總時間 (以毫秒為單位)，否則值為零。如需詳細資訊，請參閱 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `local_blk_read_time` - 如果啟用 `track_io_timing`，它會追蹤讀取本機資料檔案區塊所花費的總時間 (以毫秒為單位)，否則值為零。如需詳細資訊，請參閱 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `orcache_blk_read_time` - 如果啟用 `track_io_timing`，它會追蹤從最佳化讀取快取中讀取資料檔案區塊所花費的總時間 (以毫秒為單位)，否則值為零。如需詳細資訊，請參閱 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
**注意**
`blks_read` 的值是 `storage_blks_read`、`orcache_blks_hit` 和 `local_blks_read` 的總和。
`blk_read_time` 的值是 `storage_blk_read_time`、`orcache_blk_read_time` 和 `local_blk_read_time` 的總和。
## 使用須知
此函數適用於下列 Aurora PostgreSQL 版本：
+ 15.4 版和更新的 15 版本
+ 14.9 版和更新的 14 版本
## 範例
以下範例顯示它如何攜帶所有 `pg_stat_database` 欄並在結尾附加 6 個新欄：
```
=> select * from aurora_stat_database() where datid=14717;
-[ RECORD 1 ]------------+------------------------------
datid | 14717
datname | postgres
numbackends | 1
xact_commit | 223
xact_rollback | 4
blks_read | 1059
blks_hit | 11456
tup_returned | 27746
tup_fetched | 5220
tup_inserted | 165
tup_updated | 42
tup_deleted | 91
conflicts | 0
temp_files | 0
temp_bytes | 0
deadlocks | 0
checksum_failures |
checksum_last_failure |
blk_read_time | 3358.689
blk_write_time | 0
session_time | 1076007.997
active_time | 3684.371
idle_in_transaction_time | 0
sessions | 10
sessions_abandoned | 0
sessions_fatal | 0
sessions_killed | 0
stats_reset | 2023-01-12 20:15:17.370601+00
orcache_blks_hit | 425
orcache_blk_read_time | 89.934
storage_blks_read | 623
storage_blk_read_time | 3254.914
local_blks_read | 0
local_blk_read_time | 0
```
# aurora\$1stat\$1dml\$1activity
報告 Aurora PostgreSQL 叢集中資料庫上每種資料處理語言 (DML) 作業類型的累積活動。
## 語法
```
aurora_stat_dml_activity(database_oid)
```
## 引數
*database\$1oid*
Aurora PostgreSQL 叢集中資料庫的物件 ID (OID)。
## 傳回類型
SETOF 記錄
## 使用須知
`aurora_stat_dml_activity` 函數僅適用於與 PostgreSQL 引擎 11.6 及更新版本相容的 Aurora PostgreSQL 3.1 版。
在具有大量資料庫的 Aurora PostgreSQL 叢集上使用此函數，來識別哪些資料庫具有較多或較慢的 DML 活動，或兩者兼具。
`aurora_stat_dml_activity` 函數傳回的作業執行的次數，及 SELECT、INSERT、UPDATE 和 DELETE 作業的累積延遲 (以微秒為單位)。該報告僅包含成功的 DML 作業。
您可使用 PostgreSQL 統計數字存取函數 `pg_stat_reset` 來重置此統計數字。您可使用 `pg_stat_get_db_stat_reset_time` 函數，檢查上次重設此統計數字的時間。如需有關 PostgreSQL 統計數字存取函數的詳細資訊，請參閱 PostgreSQL 文件中的[統計數字收集器](https://www.postgresql.org/docs/9.1/monitoring-stats.html)。
## 範例
下列範例顯示如何報告已連線資料庫的 DML 活動統計數字。
```
––Define the oid variable from connected database by using \gset
=> SELECT oid,
datname
FROM pg_database
WHERE datname=(select current_database()) \gset
=> SELECT *
FROM aurora_stat_dml_activity(:oid);
select_count | select_latency_microsecs | insert_count | insert_latency_microsecs | update_count | update_latency_microsecs | delete_count | delete_latency_microsecs
--------------+--------------------------+--------------+--------------------------+--------------+--------------------------+--------------+--------------------------
178957 | 66684115 | 171065 | 28876649 | 519538 | 1454579206167 | 1 | 53027
–– Showing the same results with expanded display on
=> SELECT *
FROM aurora_stat_dml_activity(:oid);
-[ RECORD 1 ]------------+--------------
select_count | 178957
select_latency_microsecs | 66684115
insert_count | 171065
insert_latency_microsecs | 28876649
update_count | 519538
update_latency_microsecs | 1454579206167
delete_count | 1
delete_latency_microsecs | 53027
```
下列範例顯示 Aurora PostgreSQL 叢集中所有資料庫的 DML 活動統計數字。此叢集有兩個資料庫：`postgres` 和 `mydb`。以逗號分隔的清單會與 `select_count`、`select_latency_microsecs`、`insert_count`、`insert_latency_microsecs`、`update_count`、`update_latency_microsecs`、`delete_count` 和 `delete_latency_microsecs` 欄位相對應。
Aurora PostgreSQL 建立並使用一個名為 `rdsadmin` 的系統資料庫來支援管理作業，例如備份、還原、運作狀態檢查、複寫等等。這些 DML 作業對您的 Aurora PostgreSQL 叢集並無任何影響。
```
=> SELECT oid,
datname,
aurora_stat_dml_activity(oid)
FROM pg_database;
oid | datname | aurora_stat_dml_activity
-------+----------------+-----------------------------------------------------------------
14006 | template0 | (,,,,,,,)
16384 | rdsadmin | (2346623,1211703821,4297518,817184554,0,0,0,0)
1 | template1 | (,,,,,,,)
14007 | postgres | (178961,66716329,171065,28876649,519538,1454579206167,1,53027)
16401 | mydb | (200246,64302436,200036,107101855,600000,83659417514,0,0)
```
下列範例顯示所有資料庫的 DML 活動統計數字以資料欄進行編排，提高可讀性。
```
SELECT db.datname,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 1), '()') AS select_count,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 2), '()') AS select_latency_microsecs,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 3), '()') AS insert_count,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 4), '()') AS insert_latency_microsecs,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 5), '()') AS update_count,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 6), '()') AS update_latency_microsecs,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 7), '()') AS delete_count,
BTRIM(SPLIT_PART(db.asdmla::TEXT, ',', 8), '()') AS delete_latency_microsecs
FROM (SELECT datname,
aurora_stat_dml_activity(oid) AS asdmla
FROM pg_database
) AS db;
datname | select_count | select_latency_microsecs | insert_count | insert_latency_microsecs | update_count | update_latency_microsecs | delete_count | delete_latency_microsecs
----------------+--------------+--------------------------+--------------+--------------------------+--------------+--------------------------+--------------+--------------------------
template0 | | | | | | | |
rdsadmin | 4206523 | 2478812333 | 7009414 | 1338482258 | 0 | 0 | 0 | 0
template1 | | | | | | | |
fault_test | 66 | 452099 | 0 | 0 | 0 | 0 | 0 | 0
db_access_test | 1 | 5982 | 0 | 0 | 0 | 0 | 0 | 0
postgres | 42035 | 95179203 | 5752 | 2678832898 | 21157 | 441883182488 | 2 | 1520
mydb | 71 | 453514 | 0 | 0 | 1 | 190 | 1 | 152
```
下列範例顯示了資料庫 (具 OID `16401`) 之每個 DML 作業的平均累積延遲 (累積延遲除以計數)。
```
=> SELECT select_count,
select_latency_microsecs,
select_latency_microsecs/NULLIF(select_count,0) select_latency_per_exec,
insert_count,
insert_latency_microsecs,
insert_latency_microsecs/NULLIF(insert_count,0) insert_latency_per_exec,
update_count,
update_latency_microsecs,
update_latency_microsecs/NULLIF(update_count,0) update_latency_per_exec,
delete_count,
delete_latency_microsecs,
delete_latency_microsecs/NULLIF(delete_count,0) delete_latency_per_exec
FROM aurora_stat_dml_activity(16401);
-[ RECORD 1 ]------------+-------------
select_count | 451312
select_latency_microsecs | 80205857
select_latency_per_exec | 177
insert_count | 451001
insert_latency_microsecs | 123667646
insert_latency_per_exec | 274
update_count | 1353067
update_latency_microsecs | 200900695615
update_latency_per_exec | 148478
delete_count | 12
delete_latency_microsecs | 448
delete_latency_per_exec | 37
```
# aurora\$1stat\$1get\$1db\$1commit\$1latency
取得 Aurora PostgreSQL 資料庫的累積遞交延遲 (以微秒為單位)。*遞交延遲*是指用戶端提交一個遞交請求和其收到遞交確認之間的時間。
## 語法
```
aurora_stat_get_db_commit_latency(database_oid)
```
## 引數
*database\$1oid*
Aurora PostgreSQL 資料庫的物件 ID (OID)。
## 傳回類型
SETOF 記錄
## 使用須知
Amazon CloudWatch 使用此函數來計算平均遞交延遲。如需有關 Amazon CloudWatch 指標及如何對高遞交延遲進行疑難排解的詳細資訊，請參閱 [在 Amazon RDS 主控台中檢視指標](USER_Monitoring.md) 和 [利用 Amazon CloudWatch 指標對 Amazon RDS 做出更好的決策](https://aws.amazon.com/blogs/database/making-better-decisions-about-amazon-rds-with-amazon-cloudwatch-metrics/)。
您可使用 PostgreSQL 統計數字存取函數 `pg_stat_reset` 來重置此統計數字。您可使用 `pg_stat_get_db_stat_reset_time` 函數，檢查上次重設此統計數字的時間。如需有關 PostgreSQL 統計數字存取函數的詳細資訊，請參閱 PostgreSQL 文件中的[統計數字收集器](https://www.postgresql.org/docs/9.1/monitoring-stats.html)。
## 範例
下列範例會取得 `pg_database` 叢集中每個資料庫的累積遞交延遲。
```
=> SELECT oid,
datname,
aurora_stat_get_db_commit_latency(oid)
FROM pg_database;
oid | datname | aurora_stat_get_db_commit_latency
-------+----------------+-----------------------------------
14006 | template0 | 0
16384 | rdsadmin | 654387789
1 | template1 | 0
16401 | mydb | 229556
69768 | postgres | 22011
```
下列範例會取得目前已連線資料庫的累積遞交延遲。呼叫 `aurora_stat_get_db_commit_latency` 函數之前，該範例會先使用 `\gset` 來定義 `oid` 引數的變數，並從已連線的資料庫設定其值。
```
––Get the oid value from the connected database before calling aurora_stat_get_db_commit_latency
=> SELECT oid
FROM pg_database
WHERE datname=(SELECT current_database()) \gset
=> SELECT *
FROM aurora_stat_get_db_commit_latency(:oid);
aurora_stat_get_db_commit_latency
-----------------------------------
1424279160
```
下列範例會取得 `pg_database` 叢集中 `mydb` 資料庫的累積遞交延遲。接著，其會使用 `pg_stat_reset` 函數來重設此統計數字並顯示結果。最後，其可使用 `pg_stat_get_db_stat_reset_time` 函數來檢查上次重設此統計數字的時間。
```
=> SELECT oid,
datname,
aurora_stat_get_db_commit_latency(oid)
FROM pg_database
WHERE datname = 'mydb';
oid | datname | aurora_stat_get_db_commit_latency
-------+-----------+-----------------------------------
16427 | mydb | 3320370
=> SELECT pg_stat_reset();
pg_stat_reset
---------------
=> SELECT oid,
datname,
aurora_stat_get_db_commit_latency(oid)
FROM pg_database
WHERE datname = 'mydb';
oid | datname | aurora_stat_get_db_commit_latency
-------+-----------+-----------------------------------
16427 | mydb | 6
=> SELECT *
FROM pg_stat_get_db_stat_reset_time(16427);
pg_stat_get_db_stat_reset_time
--------------------------------
2021-04-29 21:36:15.707399+00
```
# aurora\$1stat\$1logical\$1wal\$1cache
顯示每個插槽的邏輯預寫日誌 (WAL) 快取使用量。
## 語法
```
SELECT * FROM aurora_stat_logical_wal_cache()
```
## 引數
無
## 傳回類型
SETOF 記錄，包含下列欄：
+ `name` - 複寫槽的名稱。
+ `active_pid` – walsender 程序的 ID。
+ `cache_hit` – 自上次重設以來的 WAL 快存命中總數。
+ `cache_miss` – 自上次重設以來的 WAL 快存未命中總數。
+ `blks_read` – WAL 快取讀取請求的總數。
+ `hit_rate` – WAL 快取命中率 (cache\$1hit / blks\$1read)。
+ `last_reset_timestamp` – 上次重設計數器的時間。
## 使用須知
此函數適用於下列 Aurora PostgreSQL 版本。
+ 15.2 版和所有更新版本
+ 14.7 及更新版本
+ 13.8 和更新版本
+ 12.12 和更新版本
+ 11.17 和更新版本
## 範例
下列範例顯示了兩個只有一個作用中 `aurora_stat_logical_wal_cache` 函數的複寫槽。
```
=> SELECT *
FROM aurora_stat_logical_wal_cache();
name | active_pid | cache_hit | cache_miss | blks_read | hit_rate | last_reset_timestamp
------------+------------+-----------+------------+-----------+----------+-------------------------------
test_slot1 | 79183 | 24 | 0 | 24 | 100.00% | 2022-08-05 17:39:56.830635+00
test_slot2 | | 1 | 0 | 1 | 100.00% | 2022-08-05 17:34:04.036795+00
(2 rows)
```
# aurora\$1stat\$1memctx\$1usage
報告每個 PostgreSQL 程序的記憶體內容使用情況。
## 語法
```
aurora_stat_memctx_usage()
```
## 引數
無
## 傳回類型
SETOF 記錄，包含下列欄：
+ `pid` – 程序的 ID。
+ `name` – 記憶體內容的名稱。
+ `allocated` – 記憶體內容從基礎記憶體子系統取得的位元組數量。
+ `used` – 提交至記憶體內容用戶端的位元組數量。
+ `instances` – 此類型現有內容目前的計數。
## 使用須知
此函數顯示每個 PostgreSQL 程序的記憶體內容使用情況。有些處理程序會標示 `anonymous`。程序不會公開，因為它們包含受限制的關鍵字。
此函數從下列 Aurora PostgreSQL 版本開始適用：
+ 15.3 版和更新的 15 版本
+ 14.8 版和更新的 14 版本
+ 13.11 版和更新的 13 版本
+ 12.15 版和更新的 12 版
+ 11.20 版和更新的 11 版本
## 範例
下列範例顯示呼叫 `aurora_stat_memctx_usage` 函數的結果。
```
=> SELECT *
FROM aurora_stat_memctx_usage();
pid| name | allocated | used | instances
-------+---------------------------------+-----------+---------+-----------
123864 | Miscellaneous | 19520 | 15064 | 3
123864 | Aurora File Context | 8192 | 616 | 1
123864 | Aurora WAL Context | 8192 | 296 | 1
123864 | CacheMemoryContext | 524288 | 422600 | 1
123864 | Catalog tuple context | 16384 | 13736 | 1
123864 | ExecutorState | 32832 | 28304 | 1
123864 | ExprContext | 8192 | 1720 | 1
123864 | GWAL record construction | 1024 | 832 | 1
123864 | MdSmgr | 8192 | 296 | 1
123864 | MessageContext | 532480 | 353832 | 1
123864 | PortalHeapMemory | 1024 | 488 | 1
123864 | PortalMemory | 8192 | 576 | 1
123864 | printtup | 8192 | 296 | 1
123864 | RelCache hash table entries | 8192 | 8152 | 1
123864 | RowDescriptionContext | 8192 | 1344 | 1
123864 | smgr relation context | 8192 | 296 | 1
123864 | Table function arguments | 8192 | 352 | 1
123864 | TopTransactionContext | 8192 | 632 | 1
123864 | TransactionAbortContext | 32768 | 296 | 1
123864 | WAL record construction | 50216 | 43904 | 1
123864 | hash table | 65536 | 52744 | 6
123864 | Relation metadata | 191488 | 124240 | 87
104992 | Miscellaneous | 9280 | 7728 | 3
104992 | Aurora File Context | 8192 | 376 | 1
104992 | Aurora WAL Context | 8192 | 296 | 1
104992 ||Autovacuum Launcher | 8192 | 296 | 1
104992 | Autovacuum database list | 16384 | 744 | 2
104992 | CacheMemoryContext | 262144 | 140288 | 1
104992 | Catalog tuple context | 8192 | 296 | 1
104992 | GWAL record construction | 1024 | 832 | 1
104992 | MdSmgr | 8192 | 296 | 1
104992 | PortalMemory | 8192 | 296 | 1
104992 | RelCache hash table entries | 8192 | 296 | 1
104992 | smgr relation context | 8192 | 296 | 1
104992 | Autovacuum start worker (tmp) | 8192 | 296 | 1
104992 | TopTransactionContext | 16384 | 592 | 2
104992 | TransactionAbortContext | 32768 | 296 | 1
104992 | WAL record construction | 50216 | 43904 | 1
104992 | hash table | 49152 | 34024 | 4
(39 rows)
```
將隱藏一些受限制的關鍵字，輸出結果如下所示：
```
postgres=>SELECT *
FROM aurora_stat_memctx_usage();
pid| name | allocated | used | instances
-------+---------------------------------+-----------+---------+-----------
5482 | anonymous | 8192 | 456 | 1
5482 | anonymous | 8192 | 296 | 1
```
# aurora\$1stat\$1optimized\$1reads\$1cache
此函數顯示階層式快取統計資料。
## 語法
```
aurora_stat_optimized_reads_cache()
```
## 引數
無
## 傳回類型
SETOF 記錄，包含下列欄：
+ `total_size` - 總最佳化讀取快取大小。
+ `used_size` - 在最佳化讀取快取中使用的頁面大小。
## 使用須知
此函數適用於下列 Aurora PostgreSQL 版本：
+ 15.4 版和更新的 15 版本
+ 14.9 版和更新的 14 版本
## 範例
下列範例會在 r6gd.8xlarge 執行個體中顯示輸出：
```
=> select pg_size_pretty(total_size) as total_size, pg_size_pretty(used_size)
as used_size from aurora_stat_optimized_reads_cache();
total_size | used_size
-----------+-----------
1054 GB | 975 GB
```
# aurora\$1stat\$1plans
傳回每個追蹤執行計劃的列。
## 語法
```
aurora_stat_plans(
showtext
)
```
## 引數
+ showtext：顯示查詢和計劃文字。有效值為 NULL、true 或 false。True 會顯示查詢和計劃文字。
## 傳回類型
傳回每個追蹤計劃的列，其中包含來自 `aurora_stat_statements` 的所有欄和下列額外欄。
+ planid：計劃識別符
+ explain\$1plan：解釋計劃文字
+ plan\$1type：
+ `no plan`：未擷取任何計劃
+ `estimate`：以預估成本擷取的計劃
+ `actual`：使用 EXPLAIN ANALYZE 擷取的計劃
+ plan\$1captured\$1time：計劃的前次擷取時間
## 使用須知
必須啟用 `aurora_compute_plan_id`，且 `pg_stat_statements` 必須位於 `shared_preload_libraries`，才能追蹤計劃。
可用的計劃數量由 `pg_stat_statements.max` 參數中設定的值所控制。啟用 `aurora_compute_plan_id` 時，您可以在 `aurora_stat_plans` 中追蹤高達此指定值的計劃。
您可從 Aurora PostgreSQL 版本 14.10、15.5 及所有其他更新的版本使用此函數。
## 範例
在下面的範例中，會擷取查詢識別符 -5471422286312252535 的兩個計劃，以及由 planid 追蹤陳述式統計資料。
```
db1=# select calls, total_exec_time, planid, plan_captured_time, explain_plan
db1-# from aurora_stat_plans(true)
db1-# where queryid = '-5471422286312252535'
calls | total_exec_time | planid | plan_captured_time | explain_plan
---------+--------------------+-------------+-------------------------------+------------------------------------------------------------------
1532632 | 3209846.097107853 | 1602979607 | 2023-10-31 03:27:16.925497+00 | Update on pgbench_branches +
| | | | -> Bitmap Heap Scan on pgbench_branches +
| | | | Recheck Cond: (bid = 76) +
| | | | -> Bitmap Index Scan on pgbench_branches_pkey +
| | | | Index Cond: (bid = 76)
61365 | 124078.18012200127 | -2054628807 | 2023-10-31 03:20:09.85429+00 | Update on pgbench_branches +
| | | | -> Index Scan using pgbench_branches_pkey on pgbench_branches+
| | | | Index Cond: (bid = 17)
```
# aurora\$1stat\$1reset\$1wal\$1cache
Resets the counter for logical wal cache.
## 語法
重設特定槽
```
SELECT * FROM aurora_stat_reset_wal_cache('slot_name')
```
重設所有槽
```
SELECT * FROM aurora_stat_reset_wal_cache(NULL)
```
## 引數
`NULL` 或 `slot_name`
## 傳回類型
狀態訊息，文字字串
+ 重設邏輯 WAL 快取計數器 – 成功訊息。此文字會在函數成功時傳回。
+ 找不到複寫槽。請再試一次。- 失敗訊息。此文字會在函數未成功時傳回。
## 使用須知
此函數適用於下列版本：
+ Aurora PostgreSQL 14.5 及更高版本
+ Aurora PostgreSQL 13.8 版及更高版本
+ Aurora PostgreSQL 12.12 版和更高版本
+ Aurora PostgreSQL 11.17 版及更高版本
## 範例
下列範例會使用 `aurora_stat_reset_wal_cache` 函數來重設名為 `test_results` 的槽，然後嘗試重設不存在的槽。
```
=> SELECT *
FROM aurora_stat_reset_wal_cache('test_slot');
aurora_stat_reset_wal_cache
--------------------------------------
Reset the logical wal cache counter.
(1 row)
=> SELECT *
FROM aurora_stat_reset_wal_cache('slot-not-exist');
aurora_stat_reset_wal_cache
-----------------------------------------------
Replication slot not found. Please try again.
(1 row)
```
# aurora\$1stat\$1resource\$1usage
報告即時資源使用率，其中包含所有 Aurora PostgreSQL 後端程序的後端資源指標和 cpu 用量。
## 語法
```
aurora_stat_resource_usage()
```
## 引數
無
## 傳回類型
SETOF 記錄與欄：
+ pid：程序識別符
+ allocated\$1memory：依程序分配的記憶體總計 (以位元組為單位)
+ used\$1memory：依程序實際使用的記憶體 (以位元組為單位)
+ cpu\$1usage\$1percent：程序的 CPU 用量百分比
## 使用須知
此函數會顯示每個 Aurora PostgreSQL 後端程序的後端資源用量。
此函數從下列 Aurora PostgreSQL 版本開始適用：
+ Aurora PostgreSQL 17.5 和更新的 17 版本
+ Aurora PostgreSQL 16.9 和更新的 16 版本
+ Aurora PostgreSQL 15.13 和更新的 15 版本
+ Aurora PostgreSQL 14.18 和更新的 14 版本
+ Aurora PostgreSQL 13.21 和更新的 13 版本
## 範例
下列範例示範 `aurora_stat_resource_usage` 函數的輸出。
```
=> select * from aurora_stat_resource_usage();
pid | allocated_memory | used_memory | cpu_usage_percent
------+------------------+-------------+-----------------------
666 | 1074032 | 333544 | 0.00729274882897963
667 | 787312 | 287360 | 0.0029263928146372746
668 | 3076776 | 1563488 | 0.006013116835953961
684 | 803744 | 307480 | 0.002226855426881142
2401 | 1232992 | 943144 | 0
647 | 8000 | 944 | 0.48853387812429855
659 | 319344 | 243000 | 0.0004135602076683591
663 | 262000 | 185736 | 0.008181301476644002
664 | 9024 | 1216 | 0.10992313082653653
(9 rows)
```
# aurora\$1stat\$1statements
顯示所有 `pg_stat_statements` 欄，並在結尾附加更多欄。
## 語法
```
aurora_stat_statements(showtext boolean)
```
## 引數
*showtext 布林值*
## 傳回類型
SETOF 記錄包含所有 `pg_stat_statements` 欄和以下附加欄。如需 `pg_stat_statements` 欄的詳細資訊，請參閱 [https://www.postgresql.org/docs/current/pgstatstatements.html](https://www.postgresql.org/docs/current/pgstatstatements.html)。
您可以使用 `pg_stat_statements_reset()` 重設此函數的統計資料。
+ `storage_blks_read` - 此陳述式從 Aurora 儲存中讀取的共用區塊總數。
+ `orcache_blks_hit` - 此陳述式最佳化讀取快取命中的總數。
+ `storage_blk_read_time`：如果啟用 `track_io_timing`，其會追蹤陳述式從 Aurora 儲存中讀取共用區塊所花費的時間總計 (以毫秒為單位)，否則值為零。如需詳細資訊，請參閱 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `local_blk_read_time`：如果啟用 `track_io_timing`，其會追蹤陳述式讀取本機區塊所花費的時間總計 (以毫秒為單位)，否則值為零。如需詳細資訊，請參閱 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `orcache_blk_read_time`：如果啟用 `track_io_timing`，其會追蹤陳述式從最佳化讀取快取中讀取共用區塊所花費的時間總計 (以毫秒為單位)，否則值為零。如需詳細資訊，請參閱 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `total_plan_peakmem`：此陳述式的所有呼叫在規劃階段期間尖峰記憶體值的總和。若要查看陳述式規劃期間的平均尖峰記憶體，請將此值除以呼叫次數。
+ `min_plan_peakmem`：此陳述式的所有呼叫在規劃期間觀察到的最小尖峰記憶體值。
+ `max_plan_peakmem`：此陳述式的所有呼叫在規劃期間的最大尖峰記憶體值。
+ `total_exec_peakmem`：此陳述式的所有呼叫在執行階段期間的尖峰記憶體值總和。若要查看陳述式執行期間的平均尖峰記憶體，請將此值除以呼叫次數。
+ `min_exec_peakmem`：此陳述式的所有呼叫在執行期間觀察的最小尖峰記憶體值 (以位元組為單位)。
+ `max_exec_peakmem`：此陳述式的所有呼叫在執行期間觀察的最大尖峰記憶體值 (以位元組為單位)。
**注意**
`total_plan_peakmen`、`min_plan_peakmem` 和 `max_plan_peakmem` 只會在 `pg_stat_statements.track_planning` 設定開啟時受到監控。
## 使用須知
若要使用 aurora\$1stat\$1statements() 函數，您必須在 `shared_preload_libraries` 參數中包含 `pg_stat_statements` 延伸模組。
此函數適用於下列 Aurora PostgreSQL 版本：
+ 15.4 版和更新的 15 版本
+ 14.9 版和更新的 14 版本
顯示尖峰記憶體的欄可從下列版本取得：
+ 16.3 及更新版本
+ 15.7 及更新版本
+ 14.12 及更新版本
## 範例
下列範例示範其如何攜帶所有 pg\$1stat\$1statements 欄，並在結尾附加 11 個新欄：
```
=> select * from aurora_stat_statements(true) where query like 'with window_max%';
-[ RECORD 1 ]----------+------------------------------------------------------------------------------------------------
userid | 16409
dbid | 5
toplevel | t
queryid | -8347523682669847482
query | with window_max as (select custid, max(scratch) over (order by scratch rows between $1 preceding
and $2 following) wmax from ts) select sum(wmax), max(custid) from window_max
plans | 0
total_plan_time | 0
min_plan_time | 0
max_plan_time | 0
mean_plan_time | 0
stddev_plan_time | 0
calls | 4
total_exec_time | 254.105121
min_exec_time | 57.503164000000005
max_exec_time | 68.687418
mean_exec_time | 63.52628025
stddev_exec_time | 5.150765359979643
rows | 4
shared_blks_hit | 200192
shared_blks_read | 0
shared_blks_dirtied | 0
shared_blks_written | 0
local_blks_hit | 0
local_blks_read | 0
local_blks_dirtied | 0
local_blks_written | 0
temp_blks_read | 0
temp_blks_written | 0
blk_read_time | 0
blk_write_time | 0
temp_blk_read_time | 0
temp_blk_write_time | 0
wal_records | 0
wal_fpi | 0
wal_bytes | 0
jit_functions | 0
jit_generation_time | 0
jit_inlining_count | 0
jit_inlining_time | 0
jit_optimization_count | 0
jit_optimization_time | 0
jit_emission_count | 0
jit_emission_time | 0
storage_blks_read | 0
orcache_blks_hit | 0
storage_blk_read_time | 0
local_blk_read_time | 0
orcache_blk_read_time | 0
total_plan_peakmem | 0
min_plan_peakmem | 0
max_plan_peakmem | 0
total_exec_peakmem | 6356224
min_exec_peakmem | 1589056
max_exec_peakmem | 1589056
```
# aurora\$1stat\$1system\$1waits
報告 Aurora PostgreSQL 資料庫執行個體的等待事件資訊。
## 語法
```
aurora_stat_system_waits()
```
## 引數
無
## 傳回類型
SETOF 記錄
## 使用須知
此函數會傳回您目前連線的資料庫執行個體所產生之每個等待事件的累積等待次數和累積等待時間。
傳回的記錄集包含下列欄位：
+ `type_id` - 等待事件類型的 ID。
+ `event_id` - 等待事件的 ID。
+ `waits` - 等待事件發生的次數。
+ `wait_time` - 等待此事件所花費的總時間 (以微秒為單位)。
此函數傳回的統計數字會在資料庫執行個體重新啟動時進行重設。
## 範例
下列範例會顯示呼叫 `aurora_stat_system_waits` 函數的結果。
```
=> SELECT *
FROM aurora_stat_system_waits();
type_id | event_id | waits | wait_time
---------+-----------+-----------+--------------
1 | 16777219 | 11 | 12864
1 | 16777220 | 501 | 174473
1 | 16777270 | 53171 | 23641847
1 | 16777271 | 23 | 319668
1 | 16777274 | 60 | 12759
.
.
.
10 | 167772231 | 204596 | 790945212
10 | 167772232 | 2 | 47729
10 | 167772234 | 1 | 888
10 | 167772235 | 2 | 64
```
下列範例顯示如何將此函數與 `aurora_stat_wait_event` 和 `aurora_stat_wait_type` 一起使用，以產生更具可讀性的結果。
```
=> SELECT type_name,
event_name,
waits,
wait_time
FROM aurora_stat_system_waits()
NATURAL JOIN aurora_stat_wait_event()
NATURAL JOIN aurora_stat_wait_type();
type_name | event_name | waits | wait_time
-----------+------------------------+----------+--------------
LWLock | XidGenLock | 11 | 12864
LWLock | ProcArrayLock | 501 | 174473
LWLock | buffer_content | 53171 | 23641847
LWLock | rdsutils | 2 | 12764
Lock | tuple | 75686 | 2033956052
Lock | transactionid | 1765147 | 47267583409
Activity | AutoVacuumMain | 136868 | 56305604538
Activity | BgWriterHibernate | 7486 | 55266949471
Activity | BgWriterMain | 7487 | 1508909964
.
.
.
IO | SLRURead | 3 | 11756
IO | WALWrite | 52544463 | 388850428
IO | XactSync | 187073 | 597041642
IO | ClogRead | 2 | 47729
IO | OutboundCtrlRead | 1 | 888
IO | OutboundCtrlWrite | 2 | 64
```
# aurora\$1stat\$1wait\$1event
列出 Aurora PostgreSQL 的所有支援等待事件。如需 Aurora PostgreSQL 等待事件的相關資訊，請參閱 [Amazon Aurora PostgreSQL 等待事件](AuroraPostgreSQL.Reference.Waitevents.md)。
## 語法
```
aurora_stat_wait_event()
```
## 引數
無
## 傳回類型
SETOF 記錄，包含下列欄：
+ type\$1id - 等待事件類型的 ID。
+ event\$1id - 等待事件的 ID。
+ type\$1name – 等待類型名稱
+ event\$1name – 等待事件名稱
## 使用須知
如要查看具事件類型而非 ID 的事件名稱，請將此函數與其他函數 (例如 `aurora_stat_wait_type` 和 `aurora_stat_system_waits`) 一起搭配使用。此函數所傳回的等待事件名稱與 `aurora_wait_report` 函數傳回的等待事件名稱相同。
## 範例
下列範例會顯示呼叫 `aurora_stat_wait_event` 函數的結果。
```
=> SELECT *
FROM aurora_stat_wait_event();
type_id | event_id | event_name
---------+-----------+-------------------------------------------
1 | 16777216 |
1 | 16777217 | ShmemIndexLock
1 | 16777218 | OidGenLock
1 | 16777219 | XidGenLock
.
.
.
9 | 150994945 | PgSleep
9 | 150994946 | RecoveryApplyDelay
10 | 167772160 | BufFileRead
10 | 167772161 | BufFileWrite
10 | 167772162 | ControlFileRead
.
.
.
10 | 167772226 | WALInitWrite
10 | 167772227 | WALRead
10 | 167772228 | WALSync
10 | 167772229 | WALSyncMethodAssign
10 | 167772230 | WALWrite
10 | 167772231 | XactSync
.
.
.
11 | 184549377 | LsnAllocate
```
下列範例連線 `aurora_stat_wait_type` 和 `aurora_stat_wait_event` 以傳回類型名稱和事件名稱，可提高可讀性。
```
=> SELECT *
FROM aurora_stat_wait_type() t
JOIN aurora_stat_wait_event() e
ON t.type_id = e.type_id;
type_id | type_name | type_id | event_id | event_name
---------+-----------+---------+-----------+-------------------------------------------
1 | LWLock | 1 | 16777216 |
1 | LWLock | 1 | 16777217 | ShmemIndexLock
1 | LWLock | 1 | 16777218 | OidGenLock
1 | LWLock | 1 | 16777219 | XidGenLock
1 | LWLock | 1 | 16777220 | ProcArrayLock
.
.
.
3 | Lock | 3 | 50331648 | relation
3 | Lock | 3 | 50331649 | extend
3 | Lock | 3 | 50331650 | page
3 | Lock | 3 | 50331651 | tuple
.
.
.
10 | IO | 10 | 167772214 | TimelineHistorySync
10 | IO | 10 | 167772215 | TimelineHistoryWrite
10 | IO | 10 | 167772216 | TwophaseFileRead
10 | IO | 10 | 167772217 | TwophaseFileSync
.
.
.
11 | LSN | 11 | 184549376 | LsnDurable
```
# aurora\$1stat\$1wait\$1type
列出 Aurora PostgreSQL 的所有支援等待類型。
## 語法
```
aurora_stat_wait_type()
```
## 引數
無
## 傳回類型
SETOF 記錄，包含下列欄：
+ type\$1id - 等待事件類型的 ID。
+ type\$1name – 等待類型名稱。
## 使用須知
如要查看具等待事件類型而非 ID 的等待事件名稱，請將此函數與其他函數 (例如 `aurora_stat_wait_event` 和 `aurora_stat_system_waits`) 一起搭配使用。此函數所傳回的等待類型名稱與 `aurora_wait_report` 函數傳回的等待類型名稱相同。
## 範例
下列範例會顯示呼叫 `aurora_stat_wait_type` 函數的結果。
```
=> SELECT *
FROM aurora_stat_wait_type();
type_id | type_name
---------+-----------
1 | LWLock
3 | Lock
4 | BufferPin
5 | Activity
6 | Client
7 | Extension
8 | IPC
9 | Timeout
10 | IO
11 | LSN
```
# aurora\$1version
傳回 Amazon Aurora PostgreSQL 相容版本號的字串值。
## 語法
```
aurora_version()
```
## 引數
無
## 傳回類型
CHAR 或 VARCHAR 字串
## 使用須知
此函數顯示 Amazon Aurora PostgreSQL 相容版本資料庫引擎的版本。版本號會以字串傳回，格式為*主要*.*次要*.*修補程式*。如需 Aurora PostgreSQL 版本號的詳細資訊，請參閱 [Aurora 版本編號](AuroraPostgreSQL.Updates.md#AuroraPostgreSQL.Updates.Versions.AuroraNumber)。
您可設定 Aurora PostgreSQL 資料庫叢集的維護時段，來選擇套用次要版本升級的時間。如要瞭解如何作業，請參閱[維持 為 Amazon Aurora 資料庫叢集](USER_UpgradeDBInstance.Maintenance.md)。
從發行 PostgreSQL 版本 13.3、12.8、11.13、10.18 及所有其他更新的版本開始，Aurora 版本編號會接著 PostgreSQL 版本編號。如需有關所有 Aurora PostgreSQL 版本的詳細資訊，請參閱 *Aurora PostgreSQL 版本備註*中的 [Amazon Aurora PostgreSQL 更新](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraPostgreSQLReleaseNotes/AuroraPostgreSQL.Updates.html)。
## 範例
下列範例顯示在執行 [PostgreSQL 12.7、Aurora PostgreSQL 版本 4.2](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraPostgreSQLReleaseNotes/AuroraPostgreSQL.Updates.html#AuroraPostgreSQL.Updates.20180305.42) 的 Aurora PostgreSQL 資料庫叢集上呼叫 `aurora_version` 函數，然後在執行 [Aurora PostgreSQL 版本 13.3](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraPostgreSQLReleaseNotes/AuroraPostgreSQL.Updates.html#AuroraPostgreSQL.Updates.20180305.133X) 的叢集上執行相同函數的結果。
```
=> SELECT * FROM aurora_version();
aurora_version
----------------
4.2.2
SELECT * FROM aurora_version();
aurora_version
----------------
13.3.0
```
此範例說明如何將函數與各種選項結合使用，以取得有關 Aurora PostgreSQL 版本的更多詳細資料。此範例具有與 PostgreSQL 版本編號不同的 Aurora 版本編號。
```
=> SHOW SERVER_VERSION;
server_version
----------------
12.7
(1 row)
=> SELECT * FROM aurora_version();
aurora_version
----------------
4.2.2
(1 row)
=> SELECT current_setting('server_version') AS "PostgreSQL Compatiblility";
PostgreSQL Compatiblility
---------------------------
12.7
(1 row)
=> SELECT version() AS "PostgreSQL Compatiblility Full String";
PostgreSQL Compatiblility Full String
-------------------------------------------------------------------------------------------------------------
PostgreSQL 12.7 on aarch64-unknown-linux-gnu, compiled by aarch64-unknown-linux-gnu-gcc (GCC) 7.4.0, 64-bit
(1 row)
=> SELECT 'Aurora: '
|| aurora_version()
|| ' Compatible with PostgreSQL: '
|| current_setting('server_version') AS "Instance Version";
Instance Version
------------------------------------------------
Aurora: 4.2.2 Compatible with PostgreSQL: 12.7
(1 row)
```
下一個範例會使用前面範例中具相同選項的函數。此範例並無與 PostgreSQL 版本編號不同的 Aurora 版本編號。
```
=> SHOW SERVER_VERSION;
server_version
----------------
13.3
=> SELECT * FROM aurora_version();
aurora_version
----------------
13.3.0
=> SELECT current_setting('server_version') AS "PostgreSQL Compatiblility";
PostgreSQL Compatiblility
---------------------------
13.3
=> SELECT version() AS "PostgreSQL Compatiblility Full String";
PostgreSQL Compatiblility Full String
-------------------------------------------------------------------------------------------------
PostgreSQL 13.3 on x86_64-pc-linux-gnu, compiled by x86_64-pc-linux-gnu-gcc (GCC) 7.4.0, 64-bit
=> SELECT 'Aurora: '
|| aurora_version()
|| ' Compatible with PostgreSQL: '
|| current_setting('server_version') AS "Instance Version";
Instance Version
-------------------------------------------------------
Aurora: 13.3.0 Compatible with PostgreSQL: 13.3
```
# aurora\$1volume\$1logical\$1start\$1lsn
傳回記錄序號 (LSN)，用於識別 Aurora 叢集磁碟區邏輯預寫日誌 (WAL) 串流中的記錄開頭。
## 語法
```
aurora_volume_logical_start_lsn()
```
## 引數
無
## 傳回類型
`pg_lsn`
## 使用須知
此函數可識別指定 Aurora 叢集磁碟區邏輯 WAL 串流中的記錄開頭。在使用邏輯複寫和 Aurora 快速複製執行主要版本升級時，您可以用此功能判斷擷取快照或資料庫複製的 LSN。然後，對於在 LSN 之後記錄的較新資料，您可以使用邏輯複寫持續進行串流，並將發布者的變更同步至訂閱用戶。
如需使用邏輯複寫進行主要版本升級的詳細資訊，請參閱 [使用邏輯複寫來執行 Aurora PostgreSQL 的主要版本升級](AuroraPostgreSQL.MajorVersionUpgrade.md)。
此函數適用於下列版本的 Aurora PostgreSQL：
+ 15.2 版和更新的 15 版本
+ 14.3 版和更新的 14 版
+ 13.6 版及更新的第 13 版本
+ 12.10 版和更新的第 12 版本
+ 11.15 和更新的第 11 版本
+ 10.20 和更新的第 10 版本
## 範例
您可以使用下列查詢取得日誌序號 (LSN)：
```
postgres=> SELECT aurora_volume_logical_start_lsn();
aurora_volume_logical_start_lsn
---------------
0/402E2F0
(1 row)
```
# aurora\$1wait\$1report
此函數顯示一段時間內的等待事件活動。
## 語法
```
aurora_wait_report([time])
```
## 引數
*時間 (選用)*
時間 (以秒為單位)。預設為 10 秒。
## 傳回類型
SETOF 記錄，包含下列欄：
+ type\$1name – 等待類型名稱
+ event\$1name – 等待事件名稱
+ wait – 等待次數
+ wait\$1time – 等待時間 (以毫秒為單位)
+ ms\$1per\$1wait – 等待次數的平均毫秒數
+ waits\$1per\$1xact – 按一筆交易次數計算的平均等待時間
+ ms\$1per\$1xact – 交易次數的平均毫秒數
## 使用須知
此函數從 Aurora PostgreSQL 1.1 版開始使用，並與 PostgreSQL 9.6.6 和更高版本相容。
如要使用此函數，你需要先建立 Aurora PostgreSQL `aurora_stat_utils` 擴充功能，如下所示：
```
=> CREATE extension aurora_stat_utils;
CREATE EXTENSION
```
如需可用 Aurora PostgreSQL 擴充功能版本的詳細資訊，請參閱 *Aurora PostgreSQL 版本備註*中的 [Amazon Aurora PostgreSQL 的擴充功能版本](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraPostgreSQLReleaseNotes/AuroraPostgreSQL.Extensions.html)。
此函數透過比較來自 aurora\$1stat\$1system\$1waits() 函數和 pg\$1stat\$1database PostgreSQL 統計數字檢視中的兩個統計資料快照來計算執行個體層級的等待事件。
如需更多 `aurora_stat_system_waits()` 和 `pg_stat_database` 的相關資訊，請參閱 *PostgreSQL 文件*中的[統計數字收集器](https://www.postgresql.org/docs/current/monitoring-stats.html#PG-STAT-DATABASE-VIEW)。
執行時，此函數會拍攝初始快照，等待指定的秒數，然後拍攝第二個快照。函數比較兩個快照並傳回差異。此差異表示執行個體在該時間間隔內的活動。
在寫入器執行個體上，函數還會顯示已提交的交易和 TPS (每秒交易數) 的數量。此函數傳回執行個體層級的資訊，並包括執行個體上的所有資料庫。
## 範例
此範例說明如何建立 aurora\$1stat\$1utils 延伸模組，以使用 aurora\$1wait\$1report 函數。
```
=> CREATE extension aurora_stat_utils;
CREATE EXTENSION
```
此範例說明如何檢查等待報告 10 秒。
```
=> SELECT *
FROM aurora_wait_report();
NOTICE: committed 34 transactions in 10 seconds (tps 3)
type_name | event_name | waits | wait_time | ms_per_wait | waits_per_xact | ms_per_xact
-----------+-------------------+-------+-----------+-------------+----------------+-------------
Client | ClientRead | 26 | 30003.00 | 1153.961 | 0.76 | 882.441
Activity | WalWriterMain | 50 | 10051.32 | 201.026 | 1.47 | 295.627
Timeout | PgSleep | 1 | 10049.52 | 10049.516 | 0.03 | 295.574
Activity | BgWriterHibernate | 1 | 10048.15 | 10048.153 | 0.03 | 295.534
Activity | AutoVacuumMain | 18 | 9941.66 | 552.314 | 0.53 | 292.402
Activity | BgWriterMain | 1 | 201.09 | 201.085 | 0.03 | 5.914
IO | XactSync | 15 | 25.34 | 1.690 | 0.44 | 0.745
IO | RelationMapRead | 12 | 0.54 | 0.045 | 0.35 | 0.016
IO | WALWrite | 84 | 0.21 | 0.002 | 2.47 | 0.006
IO | DataFileExtend | 1 | 0.02 | 0.018 | 0.03 | 0.001
```
此範例說明如何檢查等待報告 60 秒。
```
=> SELECT *
FROM aurora_wait_report(60);
NOTICE: committed 1544 transactions in 60 seconds (tps 25)
type_name | event_name | waits | wait_time | ms_per_wait | waits_per_xact | ms_per_xact
-----------+------------------------+---------+-----------+-------------+----------------+-------------
Lock | transactionid | 6422 | 477000.53 | 74.276 | 4.16 | 308.938
Client | ClientRead | 8265 | 270752.99 | 32.759 | 5.35 | 175.358
Activity | CheckpointerMain | 1 | 60100.25 | 60100.246 | 0.00 | 38.925
Timeout | PgSleep | 1 | 60098.49 | 60098.493 | 0.00 | 38.924
Activity | WalWriterMain | 296 | 60010.99 | 202.740 | 0.19 | 38.867
Activity | AutoVacuumMain | 107 | 59827.84 | 559.139 | 0.07 | 38.749
Activity | BgWriterMain | 290 | 58821.83 | 202.834 | 0.19 | 38.097
IO | XactSync | 1295 | 55220.13 | 42.641 | 0.84 | 35.764
IO | WALWrite | 6602259 | 47810.94 | 0.007 | 4276.07 | 30.966
Lock | tuple | 473 | 29880.67 | 63.173 | 0.31 | 19.353
LWLock | buffer_mapping | 142 | 3540.13 | 24.930 | 0.09 | 2.293
Activity | BgWriterHibernate | 290 | 1124.15 | 3.876 | 0.19 | 0.728
IO | BufFileRead | 7615 | 618.45 | 0.081 | 4.93 | 0.401
LWLock | buffer_content | 73 | 345.93 | 4.739 | 0.05 | 0.224
LWLock | lock_manager | 62 | 191.44 | 3.088 | 0.04 | 0.124
IO | RelationMapRead | 72 | 5.16 | 0.072 | 0.05 | 0.003
LWLock | ProcArrayLock | 1 | 2.01 | 2.008 | 0.00 | 0.001
IO | ControlFileWriteUpdate | 2 | 0.03 | 0.013 | 0.00 | 0.000
IO | DataFileExtend | 1 | 0.02 | 0.018 | 0.00 | 0.000
IO | ControlFileSyncUpdate | 1 | 0.00 | 0.000 | 0.00 | 0.000
```
# Amazon Aurora PostgreSQL 參數
您可以採用管理 Amazon RDS 資料庫執行個體的相同方式來管理您的 Amazon Aurora 資料庫叢集，方法是在資料庫參數群組中使用參數。但是 Amazon Aurora 與 Amazon RDS 的不同之處在於，Aurora 資料庫叢集具有多個資料庫執行個體。您用來管理 Amazon Aurora 資料庫叢集的部分參數適用於整個叢集，而其他參數僅適用資料庫叢集中的指定資料庫執行個體，如下所示：
+ **資料庫叢集參數群組** – 資料庫叢集參數群組包含套用至整個 Aurora 資料庫叢集的引擎組態參數集。例如，叢集快取管理是 Aurora 資料庫叢集的一項功能，由屬於資料庫叢集參數群組一部分的 `apg_ccm_enabled` 參數控制。資料庫叢集參數群組還包含組成叢集的資料庫執行個體之資料庫參數群組預設設定。
+ **資料庫參數群組** – 資料庫參數群組是一組引擎組態值，會套用至該引擎類型的特定資料庫執行個體。PostgreSQL 資料庫引擎的資料庫參數群組是由 RDS for PostgreSQL 資料庫執行個體 和 Aurora PostgreSQL 資料庫叢集使用。這些群態設定適用於因 Aurora 叢集內資料庫執行個體而有所不同的屬性，如記憶體緩衝的尺寸。
您可以管理資料庫叢集參數群組中的叢集層級參數。也可以管理資料庫參數群組中的執行個體層級參數。您可以使用 Amazon RDS 主控台、 AWS CLI或 Amazon RDS API 來管理參數。管理叢集層級參數和執行個體層級參數有不同的命令。
+ 若要管理資料庫叢集參數群組中的叢集層級參數，請使用 [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html) AWS CLI 命令。
+ 若要管理資料庫叢集中資料庫執行個體的資料庫參數群組中的執行個體層級參數，請使用 [modify-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) AWS CLI 命令。
若要進一步了解 AWS CLI，請參閱*AWS Command Line Interface 《 使用者指南*》中的[使用 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-using.html) 。
如需參數群組的詳細資訊，請參閱[Amazon Aurora 的參數群組](USER_WorkingWithParamGroups.md)。
## 查看 Aurora PostgreSQL 資料庫叢集和資料庫參數
在 AWS 管理主控台中，可以查看 RDS for PostgreSQL 資料庫執行個體及 Aurora PostgreSQL 資料庫叢集的所有可用預設參數群組。會針對每個 AWS 區域列出所有資料庫引擎和資料庫叢集類型和版本的預設參數群組。還會列出所有自訂參數群組。
您也可以使用 AWS CLI 或 Amazon RDS API，列出資料庫叢集參數群組和資料庫參數群組中包含的參數 AWS 管理主控台，而不是在 中檢視。例如，若要列出資料庫叢集參數群組中的參數，您可以使用 [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) AWS CLI 命令，如下所示：
```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name default.aurora-postgresql12
```
該命令會傳回每個參數的詳細 JSON 描述。要減少傳回的資訊量，您可以使用 `--query` 選項指定需要的資訊。例如，您可以取得預設 Aurora PostgreSQL 12 資料庫叢集參數群組的參數名稱、描述和允許值，如下所示：
對於 Linux、macOS 或 Unix：
```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name default.aurora-postgresql12 \
--query 'Parameters[].[{ParameterName:ParameterName,Description:Description,ApplyType:ApplyType,AllowedValues:AllowedValues}]'
```
在 Windows 中：
```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name default.aurora-postgresql12 ^
--query "Parameters[].[{ParameterName:ParameterName,Description:Description,ApplyType:ApplyType,AllowedValues:AllowedValues}]"
```
Aurora 資料庫叢集參數群組包括資料庫執行個體參數群組和指定 Aurora 資料庫引擎的預設值。您可以透過使用 [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) AWS CLI 命令，從相同的預設 Aurora PostgreSQL 預設參數群組取得資料庫參數清單，如下所示。
針對 Linux、macOS 或 Unix：
```
aws rds describe-db-parameters --db-parameter-group-name default.aurora-postgresql12 \
--query 'Parameters[].[{ParameterName:ParameterName,Description:Description,ApplyType:ApplyType,AllowedValues:AllowedValues}]'
```
在 Windows 中：
```
aws rds describe-db-parameters --db-parameter-group-name default.aurora-postgresql12 ^
--query "Parameters[].[{ParameterName:ParameterName,Description:Description,ApplyType:ApplyType,AllowedValues:AllowedValues}]"
```
上述命令會傳回資料庫叢集或資料庫參數群組的參數清單，其中包括查詢中指定的描述和其他詳細資訊。以下是回應範例：
```
[
[
{
"ParameterName": "apg_enable_batch_mode_function_execution",
"ApplyType": "dynamic",
"Description": "Enables batch-mode functions to process sets of rows at a time.",
"AllowedValues": "0,1"
}
],
[
{
"ParameterName": "apg_enable_correlated_any_transform",
"ApplyType": "dynamic",
"Description": "Enables the planner to transform correlated ANY Sublink (IN/NOT IN subquery) to JOIN when possible.",
"AllowedValues": "0,1"
}
],...
```
下表中包含 Aurora PostgreSQL 14 版的預設資料庫叢集參數值和資料庫參數值。
## Aurora PostgreSQL 叢集層級參數
您可以使用 AWS 管理主控台、 AWS CLI 或 Amazon RDS API，檢視特定 Aurora PostgreSQL 版本可用的叢集層級參數。如需在 RDS 主控台中檢視 Aurora PostgreSQL 資料庫叢集參數群組中參數的相關資訊，請參閱 [在 Amazon Aurora 中檢視資料庫叢集參數群組的參數值](USER_WorkingWithParamGroups.ViewingCluster.md)。
部分叢集層級參數並不適用於所有版本，而部分正被棄用。如需檢視特定 Aurora PostgreSQL 版本之參數的相關資訊，請參閱 [查看 Aurora PostgreSQL 資料庫叢集和資料庫參數](#AuroraPostgreSQL.Reference.ParameterGroups-viewing-parameters)。
例如，下表列出 Aurora PostgreSQL 第 14 版預設資料庫叢集參數群組中可用的參數。如果建立 Aurora PostgreSQL 資料庫叢集時沒有指定自己的自訂資料庫參數群組，系統將使用所選版本的預設 Aurora 資料庫叢集參數群組來建立資料庫叢集，例如`default.aurora-postgresql14`、`default.aurora-postgresql13` 等。
如需相同預設資料庫叢集參數群組的資料庫執行個體參數清單，請參閱 [Aurora PostgreSQL 執行個體層級參數](#AuroraPostgreSQL.Reference.Parameters.Instance)。
| 參數名稱 | 描述 | 預設 |
| --- | --- | --- |
| ansi\$1constraint\$1trigger\$1ordering | 將限制觸發程序的觸發順序更改為與 ANSI SQL 標準相容。 | – |
| ansi\$1force\$1foreign\$1key\$1checks | 確保無論動作中存在的各種觸發程序內容如何，參考動作 (如串聯刪除或串聯更新) 一律會執行。 | – |
| ansi\$1qualified\$1update\$1set\$1target | 支援 UPDATE 中的資料表和結構描述限定詞... SET 陳述式。 | – |
| apg\$1ccm\$1enabled | 啟用或停用叢集的叢集快取管理。 | – |
| apg\$1enable\$1batch\$1mode\$1function\$1execution | 啟用批次模式函數，以便一次處理一組資料列。 | – |
| apg\$1enable\$1correlated\$1any\$1transform | 允許規劃器盡可能將相關的任何子連結 (IN/NOT IN 子查詢) 轉換為 JOIN。 | – |
| apg\$1enable\$1function\$1migration | 允許規劃器將符合條件的純量函數遷移到 FROM 子句。 | – |
| apg\$1enable\$1not\$1in\$1transform | 允許規劃器盡可能將 NOT IN 子查詢轉換為 ANTI JOIN。 | – |
| apg\$1enable\$1remove\$1redundant\$1inner\$1joins | 允許規劃器移除冗餘的內部聯結。 | – |
| apg\$1enable\$1semijoin\$1push\$1down | 允許使用半聯結篩選器進行雜湊聯結。 | – |
| apg\$1plan\$1mgmt.capture\$1plan\$1baselines | 擷取計畫基準模式。手動 - 啟用任何 SQL 陳述式的計畫擷取，關閉 - 停用計畫擷取，自動 - 為 pg\$1stat\$1陳述式中滿足合格條件的陳述式啟用計畫擷取。 | off |
| apg\$1plan\$1mgmt.max\$1databases | 設定可使用 apg\$1plan\$1mgmt 管理查詢的資料庫數上限。 | 10 |
| apg\$1plan\$1mgmt.max\$1plans | 設定 apg\$1plan\$1mgmt 可快取的計畫數上限。 | 10000 |
| apg\$1plan\$1mgmt.plan\$1retention\$1period | 上次使用計畫後經過幾天自動刪除計畫的天數上限。 | 32 |
| apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold | 估計總計畫成本，低於此成本將執行未核准的計畫。 | 0 |
| apg\$1plan\$1mgmt.use\$1plan\$1baselines | 受管陳述式僅使用已核准或固定計畫。 | false |
| application\$1name | 設定要在統計資訊和日誌中報告的應用程式名稱。 | – |
| array\$1nulls | 允許在陣列中輸入 NULL 元素。 | – |
| aurora\$1compute\$1plan\$1id | 監控查詢執行計劃，以偵測造成目前資料庫負載的執行計劃，以及追蹤執行計劃隨時間的效能統計資料。如需更多詳細資訊，請參閱[監控 Aurora PostgreSQL 的查詢執行計劃](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)。 | on |
| authentication\$1timeout | (秒) 設定完成用戶端身分驗證的允許時間上限。 | – |
| auto\$1explain.log\$1analyze | 將 EXPLAIN ANALYZE 用於計畫日誌記錄。 | – |
| auto\$1explain.log\$1buffers | 日誌緩衝區使用情況。 | – |
| auto\$1explain.log\$1format | 用於計畫日誌記錄的 EXPLAIN 格式。 | – |
| auto\$1explain.log\$1min\$1duration | 設定執行時間下限，超出此時間就會記錄計畫。 | – |
| auto\$1explain.log\$1nested\$1statements | 記錄巢狀陳述式。 | – |
| auto\$1explain.log\$1timing | 收集計時資料而不僅是資料列數。 | – |
| auto\$1explain.log\$1triggers | 在計畫中包含觸發程序統計數字。 | – |
| auto\$1explain.log\$1verbose | 將 EXPLAIN VERBOSE 用於計畫日誌記錄。 | – |
| auto\$1explain.sample\$1rate | 待處理查詢的一部分。 | – |
| autovacuum | 啟動自動資料清理子程序。 | – |
| autovacuum\$1analyze\$1scale\$1factor | 分析之前插入、更新或刪除的元組數 (成為 reltuple 的一部分)。 | 0.05 |
| autovacuum\$1analyze\$1threshold | 分析之前插入、更新或刪除的元組數下限。 | – |
| autovacuum\$1freeze\$1max\$1age | 要自動資料清理資料表以防止交易 ID 包圍的存留期。 | – |
| autovacuum\$1max\$1workers | 設定同時執行自動清空工作者程序的數目上限。 | GREATEST(DBInstanceClassMemory/64371566592,3) |
| autovacuum\$1multixact\$1freeze\$1max\$1age | 自動清空資料表以防止 multixact 迴繞的 multixact 期限。 | – |
| autovacuum\$1naptime | (秒) 自動清空執行之間的休眠時間。 | 5 |
| autovacuum\$1vacuum\$1cost\$1delay | (毫秒) 自動清空的清空成本延遲 (以毫秒為單位)。 | 5 |
| autovacuum\$1vacuum\$1cost\$1limit | 自動資料清理在小憩前可用的清理成本金額。 | GREATEST(log(DBInstanceClassMemory/21474836480)\$1600,200) |
| autovacuum\$1vacuum\$1insert\$1scale\$1factor | 分析之前插入的元組數 (成為 reltuple 的一部分)。 | – |
| autovacuum\$1vacuum\$1insert\$1threshold | 清空之前插入的元組數下限，或用 -1 停用插入清空。 | – |
| autovacuum\$1vacuum\$1scale\$1factor | 清空之前更新或刪除的元組數 (成為 reltuple 的一小部分)。 | 0.1 |
| autovacuum\$1vacuum\$1threshold | 清空之前更新或刪除的元組數下限。 | – |
| autovacuum\$1work\$1mem | (kB) 設定每個自動清空工作者程序使用的記憶體上限。 | GREATEST(DBInstanceClassMemory/32768,131072) |
| babelfishpg\$1tds.default\$1server\$1name | 預設 Babelfish 伺服器名稱 | Microsoft SQL Server |
| babelfishpg\$1tds.listen\$1addresses | 設定用來接聽 TDS 的主機名稱或 IP 地址。 | \$1 |
| babelfishpg\$1tds.port | 設定伺服器在哪個 TDS TCP 連接埠上接聽。 | 1433 |
| babelfishpg\$1tds.tds\$1debug\$1log\$1level | 將 TDS 中的日誌記錄層級設為 0 會停用日誌記錄 | 1 |
| babelfishpg\$1tds.tds\$1default\$1numeric\$1precision | 針對要在 TDS 資料欄中繼資料中傳送的數值類型，設定預設精確度 (如果引擎未指定)。 | 38 |
| babelfishpg\$1tds.tds\$1default\$1numeric\$1scale | 針對要在 TDS 資料欄中繼資料中傳送的數值類型，設定預設小數位數 (如果引擎未指定)。 | 8 |
| babelfishpg\$1tds.tds\$1default\$1packet\$1size | 設定用於待連線 SQL Server 用戶端的預設封包大小。 | 4096 |
| babelfishpg\$1tds.tds\$1default\$1protocol\$1version | 設定用於所有待連線用戶端的預設 TDS 通訊協定版本。 | DEFAULT |
| babelfishpg\$1tds.tds\$1ssl\$1encrypt | 設定 SSL 加密選項 | 0 |
| babelfishpg\$1tds.tds\$1ssl\$1max\$1protocol\$1version | 設定 TDS 工作階段使用的最高 SSL/TLS 通訊協定版本。 | TLSv1.2 |
| babelfishpg\$1tds.tds\$1ssl\$1min\$1protocol\$1version | 設定 TDS 工作階段使用的最低 SSL/TLS 通訊協定版本。 | 來自 Aurora PostgreSQL 第 16 版的 TLSv1.2，TLSv1 適用於早於 Aurora PostgreSQL 第 16 版的版本 |
| babelfishpg\$1tsql.default\$1locale | CREATE COLLATION 建立的定序要使用的預設地區設定。 | zh-TW |
| babelfishpg\$1tsql.migration\$1mode | 定義是否支援多個使用者資料庫 | 來自 Aurora PostgreSQL 第 16 版的 multi-db，single-db 適用於早於 Aurora PostgreSQL 第 16 版的版本 |
| babelfishpg\$1tsql.server\$1collation\$1name | 預設伺服器定序的名稱 | sql\$1latin1\$1general\$1cp1\$1ci\$1as |
| babelfishpg\$1tsql.version | 設定 @@VERSION 變數的輸出 | 預設 |
| backend\$1flush\$1after | (8Kb) 幾個分頁後將先前執行的寫入排清到磁碟。 | – |
| backslash\$1quote | 設定字串常值中是否允使用 \$1\$1。 | – |
| backtrace\$1functions | 記錄這些函數中錯誤的回溯追蹤。 | – |
| bytea\$1output | 設定 bytea 的輸出格式。 | – |
| check\$1function\$1bodies | 在 CREATE FUNCTION 執行期間檢查函數本文。 | – |
| client\$1connection\$1check\$1interval | 設定執行查詢時檢查是否中斷連線的時間間隔。 | – |
| client\$1encoding | 設定用戶端字元集編碼。 | UTF8 |
| client\$1min\$1messages | 設定傳送給用戶端的訊息層級。 | – |
| compute\$1query\$1id | 計算查詢識別碼。 | auto |
| config\$1file | 設定伺服器主組態檔。 | /rdsdbdata/config/postgresql.conf |
| constraint\$1exclusion | 讓規劃器能夠使用限制條件來最佳化查詢。 | – |
| cpu\$1index\$1tuple\$1cost | 設定規劃器在索引掃描期間處理每個索引項目的成本估算。 | – |
| cpu\$1operator\$1cost | 設定規劃器處理每個運算子或函數呼叫的成本估算。 | – |
| cpu\$1tuple\$1cost | 設定規劃器處理每個元組 (資料列) 的成本估算。 | – |
| cron.database\$1name | 將資料庫設定為存放 pg\$1cron 中繼資料表 | postgres |
| cron.log\$1run | 將所有執行的任務記錄到 job\$1run\$1details 資訊表中 | on |
| cron.log\$1statement | 在執行之前記錄所有 cron 陳述式。 | off |
| cron.max\$1running\$1jobs | 可同時執行的任務數量上限。 | 5 |
| cron.use\$1background\$1workers | 允許 pg\$1cron 的背景工作者 | on |
| cursor\$1tuple\$1fraction | 設定規劃器對於將擷取之游標的資料列部分估算。 | – |
| data\$1directory | 設定伺服器資料目錄。 | /rdsdbdata/db |
| datestyle | 設定日期和時間值的顯示格式。 | – |
| db\$1user\$1namespace | 允許使用各資料庫的使用者名稱。 | – |
| deadlock\$1timeout | (毫秒) 設定在檢查死鎖前等待鎖定的時間。 | – |
| debug\$1pretty\$1print | 將剖析和計劃樹狀顯示縮排。 | – |
| debug\$1print\$1parse | 記錄每項查詢的剖析樹狀結構。 | – |
| debug\$1print\$1plan | 記錄每項查詢的執行計畫。 | – |
| debug\$1print\$1rewritten | 記錄每項查詢的重寫剖析樹狀結構。 | – |
| default\$1statistics\$1target | 設定預設統計資訊目標。 | – |
| default\$1tablespace | 設定要在其中建立資料表和索引的預設資料表空間。 | – |
| default\$1toast\$1compression | 設定可壓縮值的預設壓縮方法。 | – |
| default\$1transaction\$1deferrable | 設定新交易的預設可延遲狀態。 | – |
| default\$1transaction\$1isolation | 設定每項新交易的交易隔離層級。 | – |
| default\$1transaction\$1read\$1only | 設定新交易的預設唯讀狀態。 | – |
| effective\$1cache\$1size | (8kB) 設定規劃器對磁碟快取大小的假設。 | SUM(DBInstanceClassMemory/12038,-50003) |
| effective\$1io\$1concurrency | 磁碟子系統可以有效處理的同時要求數目。 | – |
| enable\$1async\$1append | 允許規劃器使用非同步附加計畫。 | – |
| enable\$1bitmapscan | 允許規劃器使用點陣圖掃描計畫。 | – |
| enable\$1gathermerge | 允許規劃器使用收集合併計畫。 | – |
| enable\$1hashagg | 允許規劃器使用雜湊彙總計畫。 | – |
| enable\$1hashjoin | 允許規劃器使用雜湊聯結計畫。 | – |
| enable\$1incremental\$1sort | 允許規劃器使用增量排序步驟。 | – |
| enable\$1indexonlyscan | 允許規劃器使用僅限索引掃描計畫。 | – |
| enable\$1indexscan | 允許規劃器使用索引掃描計畫。 | – |
| enable\$1material | 允許規劃器使用實體化。 | – |
| enable\$1memoize | 允許規劃器使用記憶化 | – |
| enable\$1mergejoin | 允許規劃器使用合併聯結計畫。 | – |
| enable\$1nestloop | 允許規劃器使用巢狀迴圈聯結計畫。 | – |
| enable\$1parallel\$1append | 允許規劃器使用平行附加計畫。 | – |
| enable\$1parallel\$1hash | 允許規劃器使用平行雜湊計畫。 | – |
| enable\$1partition\$1pruning | 啟用計畫時間和執行時間分割區剪除。 | – |
| enable\$1partitionwise\$1aggregate | 允許分割區彙總和分組。 | – |
| enable\$1partitionwise\$1join | 允許分割區聯結。 | – |
| enable\$1seqscan | 允許規劃器使用循序掃描計畫。 | – |
| enable\$1sort | 允許規劃器使用明確排序步驟。 | – |
| enable\$1tidscan | 允許規劃器使用 TID 掃描計畫。 | – |
| escape\$1string\$1warning | 警告一般字串常值中反斜線逸出。 | – |
| exit\$1on\$1error | 出現任何錯誤時終止工作階段。 | – |
| extra\$1float\$1digits | 設定針對浮點值顯示的位數。 | – |
| force\$1parallel\$1mode | 強制使用平行查詢設施。 | – |
| from\$1collapse\$1limit | 設定 FROM-list 大小，超過此大小就不會收合子查詢。 | – |
| geqo | 啟用基因查詢最佳化。 | – |
| geqo\$1effort | GEQO：作業是用於設定其他 GEQO 參數的預設值。 | – |
| geqo\$1generations | GEQO：演算法的反覆運算次數。 | – |
| geqo\$1pool\$1size | GEQO：人口中的個體數目。 | – |
| geqo\$1seed | GEQO：隨機路徑選取的種子。 | – |
| geqo\$1selection\$1bias | GEQO：人口中的選擇壓力。 | – |
| geqo\$1threshold | 設定 FROM 項目的閾值，超出此閾值時就會使用 GEQO。 | – |
| gin\$1fuzzy\$1search\$1limit | 設定 GIN 確切搜尋所允許的結果上限。 | – |
| gin\$1pending\$1list\$1limit | (kB) 設定 GIN 索引待定清單的大小上限。 | – |
| hash\$1mem\$1multiplier | 用於雜湊表的 work\$1mem 倍數。 | – |
| hba\$1file | 設定伺服器 hba 組態檔。 | /rdsdbdata/config/pg\$1hba.conf |
| hot\$1standby\$1feedback | 允許將回饋從熱待命傳送到主要伺服器，以避免查詢衝突。 | on |
| huge\$1pages | 減少資料庫執行個體處理大型連續記憶體區塊 (如共用緩衝區使用的記憶體區塊) 時的額外負荷。對於 t3.medium,db.t3.large、db.t4g.medium、db.t4g.large 類別以外的所有資料庫執行個體類別，預設為開啟 參數。 | on |
| ident\$1file | 設定伺服器 ident 組態檔。 | /rdsdbdata/config/pg\$1ident.conf |
| idle\$1in\$1transaction\$1session\$1timeout | (毫秒) 設定任何閒置交易的允許持續時間上限。 | 86400000 |
| idle\$1session\$1timeout | 終止閒置時間已超過指定時間量，但不在所開啟交易中的工作階段 (亦即，等待用戶端查詢) | – |
| intervalstyle | 設定間隔值的顯示格式。 | – |
| join\$1collapse\$1limit | 設定 FROM-list 大小，超過此大小就不會將 JOIN 結構扁平化。 | – |
| krb\$1caseins\$1users | 設定 GSSAPI (一般安全服務 API) 使用者名稱是否應該以不區分大小寫 (true) 方式來處理。根據預設，此參數會設為 false，因此 Kerberos 預期使用者名稱區分大小寫。如需詳細資訊，請參閱 PostgreSQL 文件中的 [GSSAPI 身分驗證](https://www.postgresql.org/docs/current/gssapi-auth.html)。 | false |
| lc\$1messages | 設定用來顯示訊息的語言。 | – |
| lc\$1monetary | 設定用於格式化貨幣金額的地區設定。 | – |
| lc\$1numeric | 設定用於格式化數字的地區設定。 | – |
| lc\$1time | 設定用於格式化日期和時間值的地區設定。 | – |
| listen\$1addresses | 設定接聽的主機名稱或 IP 地址。 | \$1 |
| lo\$1compat\$1privileges | 允許回溯相容模式以進行大型物件的權限檢查。 | 0 |
| log\$1autovacuum\$1min\$1duration | (毫秒) 設定執行時間下限，超出此時間就會記錄自動清空動作。 | 10000 |
| log\$1connections | 記錄每個成功連線。 | – |
| log\$1destination | 設定伺服器日誌輸出的目的地。 | stderr |
| log\$1directory | 設定日誌檔案的目的地目錄。 | /rdsdbdata/log/error |
| log\$1disconnections | 記錄工作階段的結尾，包括持續時間。 | – |
| log\$1duration | 記錄每個已完成 SQL 陳述式的持續時間。 | – |
| log\$1error\$1verbosity | 設定已記錄訊息的詳細資訊。 | – |
| log\$1executor\$1stats | 將執行器效能統計資訊寫入至伺服器日誌。 | – |
| log\$1file\$1mode | 設定日誌檔案的檔案許可。 | 0644 |
| log\$1filename | 設定日誌檔案的檔案名稱樣式。 | postgresql.log.%Y-%m-%d-%H%M |
| logging\$1collector | 開始子程序，將 stderr 輸出和/或 csvlog 擷取到日誌檔案中。 | 1 |
| log\$1hostname | 在連線日誌中記錄主機名稱。 | 0 |
| logical\$1decoding\$1work\$1mem | (kB) 溢出到磁碟之前，每個內部重新排序緩衝區可以使用的記憶體量。 | – |
| log\$1line\$1prefix | 控制每個日誌行前綴的資訊。 | %t:%r:%u@%d:%p]: |
| log\$1lock\$1waits | 記錄長鎖定等待。 | – |
| log\$1min\$1duration\$1sample | (毫秒) 設定執行時間下限，超出此時間就會記錄陳述式樣本。採樣由 log\$1statement\$1sample\$1rate 決定。 | – |
| log\$1min\$1duration\$1statement | (毫秒) 設定執行時間下限，超出此時間就會記錄陳述式。 | – |
| log\$1min\$1error\$1statement | 導致所有陳述式在這個層級或以上產生要記錄的錯誤。 | – |
| log\$1min\$1messages | 設定所記錄的訊息層級。 | – |
| log\$1parameter\$1max\$1length | (B) 記錄陳述式時，將記錄的參數值限制為前 N 個位元組。 | – |
| log\$1parameter\$1max\$1length\$1on\$1error | (B) 報告錯誤時，將記錄的參數值限制為前 N 個位元組。 | – |
| log\$1parser\$1stats | 將剖析器效能統計資訊寫入至伺服器日誌。 | – |
| log\$1planner\$1stats | 將規劃器效能統計資訊寫入至伺服器日誌。 | – |
| log\$1replication\$1commands | 記錄每個複寫命令。 | – |
| log\$1rotation\$1age | (分) 自動日誌檔案輪換將在 N 分鐘後發生。 | 60 |
| log\$1rotation\$1size | (kB) 自動日誌檔案輪換將在 N KB 後發生。 | 100000 |
| log\$1statement | 設定已記錄的陳述式類型。 | – |
| log\$1statement\$1sample\$1rate | 陳述式超出 log\$1min\$1duration\$1sample 的待記錄部分。 | – |
| log\$1statement\$1stats | 將累積效能統計資訊寫入至伺服器日誌。 | – |
| log\$1temp\$1files | (kB) 記錄使用大於此 KB 數的暫存檔案。 | – |
| log\$1timezone | 設定要在日誌訊息中使用的時區。 | UTC |
| log\$1transaction\$1sample\$1rate | 為新交易設定要記錄的交易部分。 | – |
| log\$1truncate\$1on\$1rotation | 在日誌輪換期間截斷名稱相同的現有日誌檔案。 | 0 |
| maintenance\$1io\$1concurrency | 用於維護作業的 effective\$1io\$1concurrency 變體。 | 1 |
| maintenance\$1work\$1mem | (kB) 設定要用於維護作業的記憶體上限。 | GREATEST(DBInstanceClassMemory/63963136\$11024,65536) |
| max\$1connections | 設定同時連線的數目上限。 | LEAST(DBInstanceClassMemory/9531392,5000) |
| max\$1files\$1per\$1process | 設定每個伺服器程序的同時開啟檔案數目上限。 | – |
| max\$1locks\$1per\$1transaction | 設定每項交易的鎖定數目上限。 | 64 |
| max\$1logical\$1replication\$1workers | 邏輯複寫工作者程序數上限。 | – |
| max\$1parallel\$1maintenance\$1workers | 設定每項維護作業的平行程序數上限。 | – |
| max\$1parallel\$1workers | 設定同時處於作用中狀態的平行工作者數上限。 | GREATEST(\$1DBInstanceVCPU/2,8) |
| max\$1parallel\$1workers\$1per\$1gather | 設定每個執行器節點的平行程序數上限。 | – |
| max\$1pred\$1locks\$1per\$1page | 設定每頁的預測鎖定元組數上限。 | – |
| max\$1pred\$1locks\$1per\$1relation | 設定每個關係的預測鎖定分頁和元組數上限。 | – |
| max\$1pred\$1locks\$1per\$1transaction | 設定每項交易的述詞鎖定數目上限。 | – |
| max\$1prepared\$1transactions | 設定同時備妥交易的數目上限。 | 0 |
| max\$1replication\$1slots | 設定伺服器可支援的複寫槽數上限。 | 20 |
| max\$1slot\$1wal\$1keep\$1size | (MB) 如果 WAL 占用了磁碟的這麼多空間，複寫槽將標記為失敗，並釋出區段進行刪除或回收。 | – |
| max\$1stack\$1depth | (kB) 設定堆疊深度上限 (以 KB 為單位)。 | 6144 |
| max\$1standby\$1streaming\$1delay | (毫秒) 設定熱待命伺服器處理已串流的 WAL 資料時，取消查詢前的延遲上限。 | 14000 |
| max\$1sync\$1workers\$1per\$1subscription | 每個訂閱的同步工作者數上限 | 2 |
| max\$1wal\$1senders | 設定同時執行 WAL 傳送器程序數上限。 | 10 |
| max\$1worker\$1processes | 設定並行工作者程序數上限。 | GREATEST(\$1DBInstanceVCPU\$12,8) |
| min\$1dynamic\$1shared\$1memory | (MB) 啟動時保留的動態共用記憶體數量。 | – |
| min\$1parallel\$1index\$1scan\$1size | (8kB) 設定平行掃描的索引資料量下限。 | – |
| min\$1parallel\$1table\$1scan\$1size | (8kB) 設定平行掃描的資料表資料量下限。 | – |
| old\$1snapshot\$1threshold | (分) 經過多長時間後快照過時而無法讀取拍攝快照後更改的頁面。 | – |
| orafce.nls\$1date\$1format | 模擬 Oracle 日期輸出行為。 | – |
| orafce.timezone | 指定用於 sysdate 函數的時區。 | – |
| parallel\$1leader\$1participation | 控制「收集」和「收集合併」是否也執行子計畫。 | – |
| parallel\$1setup\$1cost | 設定規劃器啟動平行查詢工作者程序的成本估算。 | – |
| parallel\$1tuple\$1cost | 設定規劃器將每個元組 (資料列) 從工作者傳遞到主要後端的成本估算。 | – |
| password\$1encryption | 加密密碼。 | – |
| pgaudit.log | 指定工作階段稽核日誌記錄要記錄哪些陳述式類別。 | – |
| pgaudit.log\$1catalog | 指定在陳述式中的所有關係都在 pg\$1catalog 中的情況下，應啟用工作階段日誌記錄。 | – |
| pgaudit.log\$1level | 指定要用於日誌項目的日誌層級。 | – |
| pgaudit.log\$1parameter | 指定稽核日誌記錄應包括隨陳述式一起傳遞的參數。 | – |
| pgaudit.log\$1relation | 指定工作階段稽核日誌記錄是否應為 SELECT 或 DML 陳述式中參考的每個關係 (TABLE、VIEW 等) 建立單獨的日誌項目。 | – |
| pgaudit.log\$1statement\$1once | 指定日誌記錄包含的陳述式文字和參數，具有陳述式/子陳述式組合的第一個日誌項目，還是具有每個項目。 | – |
| pgaudit.role | 指定用於物件稽核日誌記錄的主要角色。 | – |
| pg\$1bigm.enable\$1recheck | 指定是否執行重新檢查 (全文檢索搜尋的內部程序)。 | on |
| pg\$1bigm.gin\$1key\$1limit | 指定用於全文檢索搜尋的搜尋關鍵字 2-gram 數上限。 | 0 |
| pg\$1bigm.last\$1update | 報告 pg\$1bigm 模組的上次更新日期。 | 2013.11.22 |
| pg\$1bigm.similarity\$1limit | 指定相似性搜尋使用的閾值下限。 | 0.3 |
| pg\$1hint\$1plan.debug\$1print | 記錄提示剖析的結果。 | – |
| pg\$1hint\$1plan.enable\$1hint | 強制規劃器使用查詢前的提示註解中指定的計畫。 | – |
| pg\$1hint\$1plan.enable\$1hint\$1table | 強制規劃器不透過使用資料表查閱來取得提示。 | – |
| pg\$1hint\$1plan.message\$1level | 偵錯訊息的訊息層級。 | – |
| pg\$1hint\$1plan.parse\$1messages | 剖析錯誤的訊息層級。 | – |
| pglogical.batch\$1inserts | 可能情況下批次插入 | – |
| pglogical.conflict\$1log\$1level | 設定用於記錄已解決衝突的日誌層級。 | – |
| pglogical.conflict\$1resolution | 設定用於可解決衝突的衝突解決方法。 | – |
| pglogical.extra\$1connection\$1options | 要新增到所有對等節點連線的連線選項 | – |
| pglogical.synchronous\$1commit | pglogical 特定的同步遞交值 | – |
| pglogical.use\$1spi | 使用 SPI 而不是低層級 API 來套用變更 | – |
| pgtle.clientauth\$1databases\$1to\$1skip | 對於 clientauth 功能，要略過的資料庫清單。 | – |
| pgtle.clientauth\$1db\$1name | 控制用於 clientauth 功能的資料庫。 | – |
| pgtle.clientauth\$1num\$1parallel\$1workers | 用於 clientauth 功能的背景工作者數量。 | – |
| pgtle.clientauth\$1users\$1to\$1skip | 對於 clientauth 功能，要略過的使用者清單。 | – |
| pgtle.enable\$1clientauth | 啟用 clientauth 功能。 | – |
| pgtle.passcheck\$1db\$1name | 設定要用於整個叢集 passcheck 功能的資料庫。 | – |
| pg\$1prewarm.autoprewarm | 開始自動預熱工作者。 | – |
| pg\$1prewarm.autoprewarm\$1interval | 設定共用緩衝區傾印之間的間隔 | – |
| pg\$1similarity.block\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.block\$1threshold | 設定 Block 相似性函數使用的閾值。 | – |
| pg\$1similarity.block\$1tokenizer | 設定 Block 相似性函數的字符化工具。 | – |
| pg\$1similarity.cosine\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.cosine\$1threshold | 設定 Cosine 相似性函數使用的閾值。 | – |
| pg\$1similarity.cosine\$1tokenizer | 設定 Cosine 相似性函數的字符化工具。 | – |
| pg\$1similarity.dice\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.dice\$1threshold | 設定 Dice 相似性量值使用的閾值。 | – |
| pg\$1similarity.dice\$1tokenizer | 設定 Dice 相似性量值的字符化工具。 | – |
| pg\$1similarity.euclidean\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.euclidean\$1threshold | 設定 Euclidean 相似性量值使用的閾值。 | – |
| pg\$1similarity.euclidean\$1tokenizer | 設定 Euclidean 相似性量值的字符化工具。 | – |
| pg\$1similarity.hamming\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.hamming\$1threshold | 設定 Block 相似性指標使用的閾值。 | – |
| pg\$1similarity.jaccard\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.jaccard\$1threshold | 設定 Jaccard 相似性量值使用的閾值。 | – |
| pg\$1similarity.jaccard\$1tokenizer | 設定 Jaccard 相似性量值的字符化工具。 | – |
| pg\$1similarity.jaro\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.jaro\$1threshold | 設定 Jaro 相似性量值使用的閾值。 | – |
| pg\$1similarity.jarowinkler\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.jarowinkler\$1threshold | 設定 Jarowinkler 相似性量值使用的閾值。 | – |
| pg\$1similarity.levenshtein\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.levenshtein\$1threshold | 設定 Levenshtein 相似性量值使用的閾值。 | – |
| pg\$1similarity.matching\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.matching\$1threshold | 設定匹配係數相似性量值使用的閾值。 | – |
| pg\$1similarity.matching\$1tokenizer | 設定匹配係數相似性量值的字符化工具。 | – |
| pg\$1similarity.mongeelkan\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.mongeelkan\$1threshold | 設定 Monge-Elkan 相似性量值使用的閾值。 | – |
| pg\$1similarity.mongeelkan\$1tokenizer | 設定 Monge-Elkan 相似性量值的字符化工具。 | – |
| pg\$1similarity.nw\$1gap\$1penalty | 設定 Needleman-Wunsch 相似性量值使用的空位罰分。 | – |
| pg\$1similarity.nw\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.nw\$1threshold | 設定 Needle-Munsch 相似性量值使用的閾值。 | – |
| pg\$1similarity.overlap\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.overlap\$1threshold | 設定重疊係數相似性量值使用的閾值。 | – |
| pg\$1similarity.overlap\$1tokenizer | 設定重疊係數相似性量值的字符化工具。 | – |
| pg\$1similarity.qgram\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.qgram\$1threshold | 設定 Q-Gram 相似性量值使用的閾值。 | – |
| pg\$1similarity.qgram\$1tokenizer | 設定 Q-Gram 量值的字符化工具。 | – |
| pg\$1similarity.swg\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.swg\$1threshold | 設定 Smith-Waterman-Gotoh 相似性量值使用的閾值。 | – |
| pg\$1similarity.sw\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.sw\$1threshold | 設定 Smith-Waterman 相似性量值使用的閾值。 | – |
| pg\$1stat\$1statements.max | 設定 pg\$1stat\$1statements 追蹤的陳述式數上限。 | – |
| pg\$1stat\$1statements.save | 儲存伺服器關閉期間的 pg\$1stat\$1list 統計數字。 | – |
| pg\$1stat\$1statements.track | 選擇 pg\$1stat\$1statements 追蹤哪些陳述式。 | – |
| pg\$1stat\$1statements.track\$1planning | 選擇 pg\$1stat\$1statements 是否追蹤計畫持續時間。 | – |
| pg\$1stat\$1statements.track\$1utility | 選擇 pg\$1stat\$1statements 是否追蹤實用程序命令。 | – |
| plan\$1cache\$1mode | 控制自訂計畫或通用計畫的規劃器選擇。 | – |
| port | 設定伺服器在哪個 TCP 連接埠上接聽。 | EndPointPort |
| postgis.gdal\$1enabled\$1drivers | 啟用或停用 Postgres 9.3.5 及更新版本中搭配 PostGIS 使用的 GDAL 驅動程式。 | ENABLE\$1ALL |
| quote\$1all\$1identifiers | 產生 SQL 片段時為所有識別符新增引號。 | – |
| random\$1page\$1cost | 設定規劃器對於非循序擷取磁碟分頁的成本估算。 | – |
| rdkit.dice\$1threshold | Dice 相似性的較低閾值。相似性低於閾值的分子與 \$1 操作不相似。 | – |
| rdkit.do\$1chiral\$1sss | 子結構相符時應考慮立體化學。若為 false，則不會在子結構相符項目中使用立體化學資訊。 | – |
| rdkit.tanimoto\$1threshold | Tanimoto 相似性的較低閾值。相似性低於閾值的分子與 % 操作不相似。 | – |
| rds.accepted\$1password\$1auth\$1method | 使用本機儲存的密碼強制驗證連線。 | md5\$1scram |
| rds.adaptive\$1autovacuum | RDS 參數用於啟用/停用調整式自動清空。 | 1 |
| rds.babelfish\$1status | RDS 參數用於啟用/停用 Babelfish for Aurora PostgreSQL。 | off |
| rds.enable\$1plan\$1management | 啟用或停用 apg\$1plan\$1mgmt 擴充功能。 | 0 |
| rds.extensions | RDS 提供的延伸模組清單 | address\$1standardizer、address\$1standardizer\$1data\$1us、apg\$1plan\$1mgmt、aurora\$1stat\$1utils、amcheck、autoinc、aws\$1commons、aws\$1ml、aws\$1s3、aws\$1lambda、bool\$1plperl、bloom、btree\$1gin、btree\$1gist、citext、cube、dblink、dict\$1int、dict\$1xsyn、earthdistance、fuzzystrmatch、hll、hstore、hstore\$1plperl、insert\$1username、intagg、intarray、ip4r、isn、jsonb\$1plperl、lo、log\$1fdw、ltree、moddatetime、old\$1snapshot、oracle\$1fdw、orafce、pgaudit、pgcrypto、pglogical、pgrouting、pgrowlocks、pgstattuple、pgtap、pg\$1bigm、pg\$1buffercache、pg\$1cron、pg\$1freespacemap、pg\$1hint\$1plan、pg\$1partman、pg\$1prewarm、pg\$1proctab、pg\$1repack、pg\$1similarity、pg\$1stat\$1statements、pg\$1trgm、pg\$1visibility、plcoffee、plls、plperl、plpgsql、plprofiler、pltcl、plv8、postgis、postgis\$1tiger\$1geocoder、postgis\$1raster、postgis\$1topology、postgres\$1fdw、prefix、rdkit、rds\$1tools、refint、sslinfo、tablefunc、tds\$1fdw、test\$1parser、tsm\$1system\$1rows、tsm\$1system\$1time、unaccent、uuid-ossp |
| rds.force\$1admin\$1logging\$1level | 查看客户資料庫中 RDS 管理員使用者動作的日誌訊息。 | – |
| rds.force\$1autovacuum\$1logging\$1level | 查看與自動清空作業相關的日誌訊息。 | WARNING |
| rds.force\$1ssl | 強制 SSL 連線。 | 0 |
| rds.global\$1db\$1rpo | (秒) 還原點目標閾值 (以秒為單位)，違反此閾值時會阻止使用者遞交。 此參數主要用於 Aurora PostgreSQL 型全球資料庫。對於非全球資料庫，請保留預設值。如需使用此參數的詳細資訊，請參閱 [管理 Aurora PostgreSQL – 全域資料庫的 RPO](aurora-global-database-disaster-recovery.md#aurora-global-database-manage-recovery)。 | – |
| rds.logical\$1replication | 允許邏輯解碼。 | 0 |
| rds.logically\$1replicate\$1unlogged\$1tables | 未記錄的資料表是以邏輯方式複寫。 | 1 |
| rds.log\$1retention\$1period | Amazon RDS 會刪除超過 N 分鐘的 PostgreSQL 日誌 | 4320 |
| rds.pg\$1stat\$1ramdisk\$1size | 統計資料 Ramdisk 的大小 (以 MB 為單位) 。若為非零值將設定 Ramdisk。此參數僅適用於Aurora PostgreSQL 14 及更低版本。 | 0 |
| rds.rds\$1superuser\$1reserved\$1connections | 設定為 rds\$1superusers 保留的連線槽數。此參數僅適用於第 15 版和更舊版本。如需詳細資訊，請參閱 PostgreSQL 文件[保留的連線](https://www.postgresql.org/docs/current/runtime-config-connection.html#GUC-RESERVED-CONNECTIONS)。 | 2 |
| rds.restrict\$1password\$1commands | 將與密碼相關的命令限制為 rds\$1password 的成員 | – |
| rds.superuser\$1variables | 僅限進階使用者變數清單，我們提升了 rds\$1superuser 修改陳述式。 | session\$1replication\$1role |
| recovery\$1init\$1sync\$1method | 設定在損毀復原之前同步處理資料目錄的方法。 | syncfs |
| remove\$1temp\$1files\$1after\$1crash | 後端當機後移除暫存檔案。 | 0 |
| restart\$1after\$1crash | 後端當機後重新初始化伺服器。 | – |
| row\$1security | 啟用資料列安全性。 | – |
| search\$1path | 針對不符合結構描述的名稱設定結構描述搜尋順序。 | – |
| seq\$1page\$1cost | 設定規劃器對循序擷取磁碟分頁的成本估算。 | – |
| session\$1replication\$1role | 設定觸發器和重寫規則的工作階段行為。 | – |
| shared\$1buffers | (8kB) 設定伺服器所用的共用記憶體緩衝區數目。 | SUM(DBInstanceClassMemory/12038,-50003) |
| shared\$1preload\$1libraries | 列出要預先載入到伺服器的共用程式庫。 | pg\$1stat\$1statements |
| ssl | 啟用 SSL 連線。 | 1 |
| ssl\$1ca\$1file | SSL 伺服器授權檔案的位置。 | /rdsdbdata/rds-metadata/ca-cert.pem |
| ssl\$1cert\$1file | SSL 伺服器憑證檔案的位置。 | /rdsdbdata/rds-metadata/server-cert.pem |
| ssl\$1ciphers | 設定要在安全連線上使用的允許 TLS 密碼清單。 | – |
| ssl\$1crl\$1dir | SSL 憑證撤銷清單目錄的位置。 | /rdsdbdata/rds-metadata/ssl\$1crl\$1dir/ |
| ssl\$1key\$1file | SSL 伺服器私有金鑰檔案的位置 | /rdsdbdata/rds-metadata/server-key.pem |
| ssl\$1max\$1protocol\$1version | 設定允許的最高 SSL/TLS 通訊協定版本 | – |
| ssl\$1min\$1protocol\$1version | 設定允許的最低 SSL/TLS 通訊協定版本 | TLSv1.2 |
| standard\$1conforming\$1strings | 導致 ... 字串逐字地處理反斜線。 | – |
| statement\$1timeout | (毫秒) 設定任何陳述式允許的持續時間上限。 | – |
| stats\$1temp\$1directory | 將暫存統計數字檔案寫入指定目錄。 | /rdsdbdata/db/pg\$1stat\$1tmp |
| superuser\$1reserved\$1connections | 設定為進階使用者保留的連線槽數。 | 3 |
| synchronize\$1seqscans | 啟用已同步的循序掃描。 | – |
| synchronous\$1commit | 設定目前交易的同步層級。 | on |
| tcp\$1keepalives\$1count | TCP 保持連線重新傳輸的數量上限 | – |
| tcp\$1keepalives\$1idle | (秒)發出 TCP 存留之間的時間。 | – |
| tcp\$1keepalives\$1interval | (秒) TCP 存留重新傳輸之間的時間。 | – |
| temp\$1buffers | (8kB) 設定每個工作階段所用的臨時緩衝區數上限。 | – |
| temp\$1file\$1limit | 限制指定 PostgreSQL 程序可用於暫存檔案的磁碟空間總量 (以 KB 為單位)，不包括用於明確暫存資料表的空間 | -1 |
| temp\$1tablespaces | 設定要用於暫存資料表和排序檔案的資料表空間。 | – |
| timezone | 設定可供顯示和解譯時間戳記的時區。 | UTC |
| track\$1activities | 收集有關執行命令的資訊。 | – |
| track\$1activity\$1query\$1size | 設定為 pg\$1stat\$1activity.current\$1query 保留的大小 (以位元組為單位)。 | 4096 |
| track\$1commit\$1timestamp | Collects transaction commit time. | – |
| track\$1counts | 收集資料庫活動的統計資訊。 | – |
| track\$1functions | 收集資料庫活動的功能層級統計資訊。 | pl |
| track\$1io\$1timing | 收集資料庫輸入/輸出活動的計時統計數字。 | 1 |
| track\$1wal\$1io\$1timing | 收集 WAL I/O 活動的計時統計資料。 | – |
| transform\$1null\$1equals | 將 expr=NULL 視為 expr IS NULL。 | – |
| update\$1process\$1title | 更新程序標題以顯示作用中的 SQL 命令。 | – |
| vacuum\$1cost\$1delay | (毫秒) 清空成本延遲 (以毫秒為單位)。 | – |
| vacuum\$1cost\$1limit | 在小憩前可用的清理成本金額。 | – |
| vacuum\$1cost\$1page\$1dirty | 清理所變更之頁面的清理成本。 | – |
| vacuum\$1cost\$1page\$1hit | 在緩衝區快取中找到之頁面的清理成本。 | – |
| vacuum\$1cost\$1page\$1miss | 在緩衝區快取中找不到之頁面的清理成本。 | 0 |
| vacuum\$1defer\$1cleanup\$1age | 應延遲清空和熱清理 (如果有的話) 的交易數目。 | – |
| vacuum\$1failsafe\$1age | 清空作業應觸發失效安全的存留期，以避免環繞式中斷。 | 1200000000 |
| vacuum\$1freeze\$1min\$1age | 清空作業應凍結資料表列的存留期下限。 | – |
| vacuum\$1freeze\$1table\$1age | 清空作業應掃描整個資料表以凍結元組的存留期。 | – |
| vacuum\$1multixact\$1failsafe\$1age | 清空作業應觸發失效安全的 Multixact 存留期，以避免環繞式中斷。 | 1200000000 |
| vacuum\$1multixact\$1freeze\$1min\$1age | 清空作業應凍結資料表列中 MultiXactId 的存留期下限。 | – |
| vacuum\$1multixact\$1freeze\$1table\$1age | 清空作業應掃描整個資料表以凍結元組的 Multixact 存留期。 | – |
| wal\$1buffers | (8kB) 為 WAL 設定共用記憶體中的磁碟分頁緩衝區數目。 | – |
| wal\$1receiver\$1create\$1temp\$1slot | 設定 WAL 接收機在設定永久槽時是否應建立臨時複寫槽。 | 0 |
| wal\$1receiver\$1status\$1interval | (秒) 設定向主伺服器報告 WAL 接收器狀態之間的間隔上限。 | – |
| wal\$1receiver\$1timeout | (毫秒) 設定從主伺服器接收資料的等待時間上限。 | 30000 |
| wal\$1sender\$1timeout | (毫秒) 設定等待 WAL 複寫的等待時間上限。 | – |
| work\$1mem | (kB) 設定要用於查詢工作空間的記憶體上限。 | – |
| xmlbinary | 設定有多少二進位值要在 XML 中編碼。 | – |
| xmloption | 設定要將明確剖析和序列化作業中的 XML 資料視為文件或內容片段。 | – |
## Aurora PostgreSQL 執行個體層級參數
您可以使用 AWS 管理主控台、 AWS CLI 或 Amazon RDS API，檢視特定 Aurora PostgreSQL 版本可用的執行個體層級參數。如需在 RDS 主控台中檢視 Aurora PostgreSQL 資料庫參數群組中參數的相關資訊，請參閱 [在 Amazon Aurora 中檢視資料庫參數群組的參數值](USER_WorkingWithParamGroups.Viewing.md)。
部分執行個體層級參數並不適用於所有版本，而部分正被棄用。如需檢視特定 Aurora PostgreSQL 版本之參數的相關資訊，請參閱 [查看 Aurora PostgreSQL 資料庫叢集和資料庫參數](#AuroraPostgreSQL.Reference.ParameterGroups-viewing-parameters)。
例如，下表列出套用至 Aurora PostgreSQL 資料庫叢集中特定資料庫執行個體的所有參數。此清單是透過對 `--db-parameter-group-name`值執行 [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) AWS CLI 命令`default.aurora-postgresql14`而產生。
如需相同預設資料庫參數群組的資料庫叢集參數清單，請參閱 [Aurora PostgreSQL 叢集層級參數](#AuroraPostgreSQL.Reference.Parameters.Cluster)。
| 參數名稱 | 描述 | 預設 |
| --- | --- | --- |
| apg\$1enable\$1batch\$1mode\$1function\$1execution | 啟用批次模式函數，以便一次處理一組資料列。 | – |
| apg\$1enable\$1correlated\$1any\$1transform | 允許規劃器盡可能將相關的任何子連結 (IN/NOT IN 子查詢) 轉換為 JOIN。 | – |
| apg\$1enable\$1function\$1migration | 允許規劃器將符合條件的純量函數遷移到 FROM 子句。 | – |
| apg\$1enable\$1not\$1in\$1transform | 允許規劃器盡可能將 NOT IN 子查詢轉換為 ANTI JOIN。 | – |
| apg\$1enable\$1remove\$1redundant\$1inner\$1joins | 允許規劃器移除冗餘的內部聯結。 | – |
| apg\$1enable\$1semijoin\$1push\$1down | 允許使用半聯結篩選器進行雜湊聯結。 | – |
| apg\$1plan\$1mgmt.capture\$1plan\$1baselines | 擷取計畫基準模式。手動 - 啟用任何 SQL 陳述式的計畫擷取，關閉 - 停用計畫擷取，自動 - 為 pg\$1stat\$1陳述式中滿足合格條件的陳述式啟用計畫擷取。 | off |
| apg\$1plan\$1mgmt.max\$1databases | 設定可使用 apg\$1plan\$1mgmt 管理查詢的資料庫數上限。 | 10 |
| apg\$1plan\$1mgmt.max\$1plans | 設定 apg\$1plan\$1mgmt 可快取的計畫數上限。 | 10000 |
| apg\$1plan\$1mgmt.plan\$1retention\$1period | 上次使用計畫後經過幾天自動刪除計畫的天數上限。 | 32 |
| apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold | 估計總計畫成本，低於此成本將執行未核准的計畫。 | 0 |
| apg\$1plan\$1mgmt.use\$1plan\$1baselines | 受管陳述式僅使用已核准或固定計畫。 | false |
| application\$1name | 設定要在統計資訊和日誌中報告的應用程式名稱。 | – |
| aurora\$1compute\$1plan\$1id | 監控查詢執行計劃，以偵測造成目前資料庫負載的執行計劃，以及追蹤執行計劃隨時間的效能統計資料。如需更多詳細資訊，請參閱[監控 Aurora PostgreSQL 的查詢執行計劃](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)。 | on |
| aurora\$1temp\$1space\$1size | (MB) 針對具有支援執行個體類別的 Aurora I/O 最佳化叢集上已啟用最佳化讀取的暫存物件，設定分配的空間大小。 | DBInstanceClassMemory/524288 |
| authentication\$1timeout | (秒) 設定完成用戶端身分驗證的允許時間上限。 | – |
| auto\$1explain.log\$1analyze | 將 EXPLAIN ANALYZE 用於計畫日誌記錄。 | – |
| auto\$1explain.log\$1buffers | 日誌緩衝區使用情況。 | – |
| auto\$1explain.log\$1format | 用於計畫日誌記錄的 EXPLAIN 格式。 | – |
| auto\$1explain.log\$1min\$1duration | 設定執行時間下限，超出此時間就會記錄計畫。 | – |
| auto\$1explain.log\$1nested\$1statements | 記錄巢狀陳述式。 | – |
| auto\$1explain.log\$1timing | 收集計時資料而不僅是資料列數。 | – |
| auto\$1explain.log\$1triggers | 在計畫中包含觸發程序統計數字。 | – |
| auto\$1explain.log\$1verbose | 將 EXPLAIN VERBOSE 用於計畫日誌記錄。 | – |
| auto\$1explain.sample\$1rate | 待處理查詢的一部分。 | – |
| babelfishpg\$1tds.listen\$1addresses | 設定用來接聽 TDS 的主機名稱或 IP 地址。 | \$1 |
| babelfishpg\$1tds.tds\$1debug\$1log\$1level | 將 TDS 中的日誌記錄層級設為 0 會停用日誌記錄 | 1 |
| backend\$1flush\$1after | (8Kb) 幾個分頁後將先前執行的寫入排清到磁碟。 | – |
| bytea\$1output | 設定 bytea 的輸出格式。 | – |
| check\$1function\$1bodies | 在 CREATE FUNCTION 執行期間檢查函數本文。 | – |
| client\$1connection\$1check\$1interval | 設定執行查詢時檢查是否中斷連線的時間間隔。 | – |
| client\$1min\$1messages | 設定傳送給用戶端的訊息層級。 | – |
| config\$1file | 設定伺服器主組態檔。 | /rdsdbdata/config/postgresql.conf |
| constraint\$1exclusion | 讓規劃器能夠使用限制條件來最佳化查詢。 | – |
| cpu\$1index\$1tuple\$1cost | 設定規劃器在索引掃描期間處理每個索引項目的成本估算。 | – |
| cpu\$1operator\$1cost | 設定規劃器處理每個運算子或函數呼叫的成本估算。 | – |
| cpu\$1tuple\$1cost | 設定規劃器處理每個元組 (資料列) 的成本估算。 | – |
| cron.database\$1name | 將資料庫設定為存放 pg\$1cron 中繼資料表 | postgres |
| cron.log\$1run | 將所有執行的任務記錄到 job\$1run\$1details 資訊表中 | on |
| cron.log\$1statement | 在執行之前記錄所有 cron 陳述式。 | off |
| cron.max\$1running\$1jobs | 可同時執行的任務數量上限。 | 5 |
| cron.use\$1background\$1workers | 允許 pg\$1cron 的背景工作者 | on |
| cursor\$1tuple\$1fraction | 設定規劃器對於將擷取之游標的資料列部分估算。 | – |
| db\$1user\$1namespace | 允許使用各資料庫的使用者名稱。 | – |
| deadlock\$1timeout | (毫秒) 設定在檢查死鎖前等待鎖定的時間。 | – |
| debug\$1pretty\$1print | 將剖析和計劃樹狀顯示縮排。 | – |
| debug\$1print\$1parse | 記錄每項查詢的剖析樹狀結構。 | – |
| debug\$1print\$1plan | 記錄每項查詢的執行計畫。 | – |
| debug\$1print\$1rewritten | 記錄每項查詢的重寫剖析樹狀結構。 | – |
| default\$1statistics\$1target | 設定預設統計資訊目標。 | – |
| default\$1transaction\$1deferrable | 設定新交易的預設可延遲狀態。 | – |
| default\$1transaction\$1isolation | 設定每項新交易的交易隔離層級。 | – |
| default\$1transaction\$1read\$1only | 設定新交易的預設唯讀狀態。 | – |
| effective\$1cache\$1size | (8kB) 設定規劃器對磁碟快取大小的假設。 | SUM(DBInstanceClassMemory/12038,-50003 |
| effective\$1io\$1concurrency | 磁碟子系統可以有效處理的同時要求數目。 | – |
| enable\$1async\$1append | 允許規劃器使用非同步附加計畫。 | – |
| enable\$1bitmapscan | 允許規劃器使用點陣圖掃描計畫。 | – |
| enable\$1gathermerge | 允許規劃器使用收集合併計畫。 | – |
| enable\$1hashagg | 允許規劃器使用雜湊彙總計畫。 | – |
| enable\$1hashjoin | 允許規劃器使用雜湊聯結計畫。 | – |
| enable\$1incremental\$1sort | 允許規劃器使用增量排序步驟。 | – |
| enable\$1indexonlyscan | 允許規劃器使用僅限索引掃描計畫。 | – |
| enable\$1indexscan | 允許規劃器使用索引掃描計畫。 | – |
| enable\$1material | 允許規劃器使用實體化。 | – |
| enable\$1memoize | 允許規劃器使用記憶化 | – |
| enable\$1mergejoin | 允許規劃器使用合併聯結計畫。 | – |
| enable\$1nestloop | 允許規劃器使用巢狀迴圈聯結計畫。 | – |
| enable\$1parallel\$1append | 允許規劃器使用平行附加計畫。 | – |
| enable\$1parallel\$1hash | 允許規劃器使用平行雜湊計畫。 | – |
| enable\$1partition\$1pruning | 啟用計畫時間和執行時間分割區剪除。 | – |
| enable\$1partitionwise\$1aggregate | 允許分割區彙總和分組。 | – |
| enable\$1partitionwise\$1join | 允許分割區聯結。 | – |
| enable\$1seqscan | 允許規劃器使用循序掃描計畫。 | – |
| enable\$1sort | 允許規劃器使用明確排序步驟。 | – |
| enable\$1tidscan | 允許規劃器使用 TID 掃描計畫。 | – |
| escape\$1string\$1warning | 警告一般字串常值中反斜線逸出。 | – |
| exit\$1on\$1error | 出現任何錯誤時終止工作階段。 | – |
| force\$1parallel\$1mode | 強制使用平行查詢設施。 | – |
| from\$1collapse\$1limit | 設定 FROM-list 大小，超過此大小就不會收合子查詢。 | – |
| geqo | 啟用基因查詢最佳化。 | – |
| geqo\$1effort | GEQO：作業是用於設定其他 GEQO 參數的預設值。 | – |
| geqo\$1generations | GEQO：演算法的反覆運算次數。 | – |
| geqo\$1pool\$1size | GEQO：人口中的個體數目。 | – |
| geqo\$1seed | GEQO：隨機路徑選取的種子。 | – |
| geqo\$1selection\$1bias | GEQO：人口中的選擇壓力。 | – |
| geqo\$1threshold | 設定 FROM 項目的閾值，超出此閾值時就會使用 GEQO。 | – |
| gin\$1fuzzy\$1search\$1limit | 設定 GIN 確切搜尋所允許的結果上限。 | – |
| gin\$1pending\$1list\$1limit | (kB) 設定 GIN 索引待定清單的大小上限。 | – |
| hash\$1mem\$1multiplier | 用於雜湊表的 work\$1mem 倍數。 | – |
| hba\$1file | 設定伺服器 hba 組態檔。 | /rdsdbdata/config/pg\$1hba.conf |
| hot\$1standby\$1feedback | 允許將回饋從熱待命傳送到主要伺服器，以避免查詢衝突。 | on |
| ident\$1file | 設定伺服器 ident 組態檔。 | /rdsdbdata/config/pg\$1ident.conf |
| idle\$1in\$1transaction\$1session\$1timeout | (毫秒) 設定任何閒置交易的允許持續時間上限。 | 86400000 |
| idle\$1session\$1timeout | 終止閒置時間已超過指定時間量，但不在所開啟交易中的工作階段 (亦即，等待用戶端查詢) | – |
| join\$1collapse\$1limit | 設定 FROM-list 大小，超過此大小就不會將 JOIN 結構扁平化。 | – |
| lc\$1messages | 設定用來顯示訊息的語言。 | – |
| listen\$1addresses | 設定接聽的主機名稱或 IP 地址。 | \$1 |
| lo\$1compat\$1privileges | 允許回溯相容模式以進行大型物件的權限檢查。 | 0 |
| log\$1connections | 記錄每個成功連線。 | – |
| log\$1destination | 設定伺服器日誌輸出的目的地。 | stderr |
| log\$1directory | 設定日誌檔案的目的地目錄。 | /rdsdbdata/log/error |
| log\$1disconnections | 記錄工作階段的結尾，包括持續時間。 | – |
| log\$1duration | 記錄每個已完成 SQL 陳述式的持續時間。 | – |
| log\$1error\$1verbosity | 設定已記錄訊息的詳細資訊。 | – |
| log\$1executor\$1stats | 將執行器效能統計資訊寫入至伺服器日誌。 | – |
| log\$1file\$1mode | 設定日誌檔案的檔案許可。 | 0644 |
| log\$1filename | 設定日誌檔案的檔案名稱樣式。 | postgresql.log.%Y-%m-%d-%H%M |
| logging\$1collector | 開始子程序，將 stderr 輸出和/或 csvlog 擷取到日誌檔案中。 | 1 |
| log\$1hostname | 在連線日誌中記錄主機名稱。 | 0 |
| logical\$1decoding\$1work\$1mem | (kB) 溢出到磁碟之前，每個內部重新排序緩衝區可以使用的記憶體量。 | – |
| log\$1line\$1prefix | 控制每個日誌行前綴的資訊。 | %t:%r:%u@%d:%p]: |
| log\$1lock\$1waits | 記錄長鎖定等待。 | – |
| log\$1min\$1duration\$1sample | (毫秒) 設定執行時間下限，超出此時間就會記錄陳述式樣本。採樣由 log\$1statement\$1sample\$1rate 決定。 | – |
| log\$1min\$1duration\$1statement | (毫秒) 設定執行時間下限，超出此時間就會記錄陳述式。 | – |
| log\$1min\$1error\$1statement | 導致所有陳述式在這個層級或以上產生要記錄的錯誤。 | – |
| log\$1min\$1messages | 設定所記錄的訊息層級。 | – |
| log\$1parameter\$1max\$1length | (B) 記錄陳述式時，將記錄的參數值限制為前 N 個位元組。 | – |
| log\$1parameter\$1max\$1length\$1on\$1error | (B) 報告錯誤時，將記錄的參數值限制為前 N 個位元組。 | – |
| log\$1parser\$1stats | 將剖析器效能統計資訊寫入至伺服器日誌。 | – |
| log\$1planner\$1stats | 將規劃器效能統計資訊寫入至伺服器日誌。 | – |
| log\$1replication\$1commands | 記錄每個複寫命令。 | – |
| log\$1rotation\$1age | (分) 自動日誌檔案輪換將在 N 分鐘後發生。 | 60 |
| log\$1rotation\$1size | (kB) 自動日誌檔案輪換將在 N KB 後發生。 | 100000 |
| log\$1statement | 設定已記錄的陳述式類型。 | – |
| log\$1statement\$1sample\$1rate | 陳述式超出 log\$1min\$1duration\$1sample 的待記錄部分。 | – |
| log\$1statement\$1stats | 將累積效能統計資訊寫入至伺服器日誌。 | – |
| log\$1temp\$1files | (kB) 記錄使用大於此 KB 數的暫存檔案。 | – |
| log\$1timezone | 設定要在日誌訊息中使用的時區。 | UTC |
| log\$1truncate\$1on\$1rotation | 在日誌輪換期間截斷名稱相同的現有日誌檔案。 | 0 |
| maintenance\$1io\$1concurrency | 用於維護作業的 effective\$1io\$1concurrency 變體。 | 1 |
| maintenance\$1work\$1mem | (kB) 設定要用於維護作業的記憶體上限。 | GREATEST(DBInstanceClassMemory/63963136\$11024,65536 |
| max\$1connections | 設定同時連線的數目上限。 | LEAST(DBInstanceClassMemory/9531392,5000 |
| max\$1files\$1per\$1process | 設定每個伺服器程序的同時開啟檔案數目上限。 | – |
| max\$1locks\$1per\$1transaction | 設定每項交易的鎖定數目上限。 | 64 |
| max\$1parallel\$1maintenance\$1workers | 設定每項維護作業的平行程序數上限。 | – |
| max\$1parallel\$1workers | 設定同時處於作用中狀態的平行工作者數上限。 | GREATEST(\$1DBInstanceVCPU/2,8 |
| max\$1parallel\$1workers\$1per\$1gather | 設定每個執行器節點的平行程序數上限。 | – |
| max\$1pred\$1locks\$1per\$1page | 設定每頁的預測鎖定元組數上限。 | – |
| max\$1pred\$1locks\$1per\$1relation | 設定每個關係的預測鎖定分頁和元組數上限。 | – |
| max\$1pred\$1locks\$1per\$1transaction | 設定每項交易的述詞鎖定數目上限。 | – |
| max\$1slot\$1wal\$1keep\$1size | (MB) 如果 WAL 占用了磁碟的這麼多空間，複寫槽將標記為失敗，並釋出區段進行刪除或回收。 | – |
| max\$1stack\$1depth | (kB) 設定堆疊深度上限 (以 KB 為單位)。 | 6144 |
| max\$1standby\$1streaming\$1delay | (毫秒) 設定熱待命伺服器處理已串流的 WAL 資料時，取消查詢前的延遲上限。 | 14000 |
| max\$1worker\$1processes | 設定並行工作者程序數上限。 | GREATEST(\$1DBInstanceVCPU\$12,8 |
| min\$1dynamic\$1shared\$1memory | (MB) 啟動時保留的動態共用記憶體數量。 | – |
| min\$1parallel\$1index\$1scan\$1size | (8kB) 設定平行掃描的索引資料量下限。 | – |
| min\$1parallel\$1table\$1scan\$1size | (8kB) 設定平行掃描的資料表資料量下限。 | – |
| old\$1snapshot\$1threshold | (分) 經過多長時間後快照過時而無法讀取拍攝快照後更改的頁面。 | – |
| parallel\$1leader\$1participation | 控制「收集」和「收集合併」是否也執行子計畫。 | – |
| parallel\$1setup\$1cost | 設定規劃器啟動平行查詢工作者程序的成本估算。 | – |
| parallel\$1tuple\$1cost | 設定規劃器將每個元組 (資料列) 從工作者傳遞到主要後端的成本估算。 | – |
| pgaudit.log | 指定工作階段稽核日誌記錄要記錄哪些陳述式類別。 | – |
| pgaudit.log\$1catalog | 指定在陳述式中的所有關係都在 pg\$1catalog 中的情況下，應啟用工作階段日誌記錄。 | – |
| pgaudit.log\$1level | 指定要用於日誌項目的日誌層級。 | – |
| pgaudit.log\$1parameter | 指定稽核日誌記錄應包括隨陳述式一起傳遞的參數。 | – |
| pgaudit.log\$1relation | 指定工作階段稽核記錄是否應為 SELECT 或 DML 陳述式中參考的每個關係 (TABLE、VIEW 等) 建立單獨的日誌項目。 | – |
| pgaudit.log\$1statement\$1once | 指定日誌記錄包含的陳述式文字和參數，具有陳述式/子陳述式組合的第一個日誌項目，還是具有每個項目。 | – |
| pgaudit.role | 指定用於物件稽核日誌記錄的主要角色。 | – |
| pg\$1bigm.enable\$1recheck | 指定是否執行重新檢查 (全文檢索搜尋的內部程序)。 | on |
| pg\$1bigm.gin\$1key\$1limit | 指定用於全文檢索搜尋的搜尋關鍵字 2-gram 數上限。 | 0 |
| pg\$1bigm.last\$1update | 報告 pg\$1bigm 模組的上次更新日期。 | 2013.11.22 |
| pg\$1bigm.similarity\$1limit | 指定相似性搜尋使用的閾值下限。 | 0.3 |
| pg\$1hint\$1plan.debug\$1print | 記錄提示剖析的結果。 | – |
| pg\$1hint\$1plan.enable\$1hint | 強制規劃器使用查詢前的提示註解中指定的計畫。 | – |
| pg\$1hint\$1plan.enable\$1hint\$1table | 強制規劃器不透過使用資料表查閱來取得提示。 | – |
| pg\$1hint\$1plan.message\$1level | 偵錯訊息的訊息層級。 | – |
| pg\$1hint\$1plan.parse\$1messages | 剖析錯誤的訊息層級。 | – |
| pglogical.batch\$1inserts | 可能情況下批次插入 | – |
| pglogical.conflict\$1log\$1level | 設定用於記錄已解決衝突的日誌層級。 | – |
| pglogical.conflict\$1resolution | 設定用於可解決衝突的衝突解決方法。 | – |
| pglogical.extra\$1connection\$1options | 要新增到所有對等節點連線的連線選項 | – |
| pglogical.synchronous\$1commit | pglogical 特定的同步遞交值 | – |
| pglogical.use\$1spi | 使用 SPI 而不是低層級 API 來套用變更 | – |
| pg\$1similarity.block\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.block\$1threshold | 設定 Block 相似性函數使用的閾值。 | – |
| pg\$1similarity.block\$1tokenizer | 設定 Block 相似性函數的字符化工具。 | – |
| pg\$1similarity.cosine\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.cosine\$1threshold | 設定 Cosine 相似性函數使用的閾值。 | – |
| pg\$1similarity.cosine\$1tokenizer | 設定 Cosine 相似性函數的字符化工具。 | – |
| pg\$1similarity.dice\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.dice\$1threshold | 設定 Dice 相似性量值使用的閾值。 | – |
| pg\$1similarity.dice\$1tokenizer | 設定 Dice 相似性量值的字符化工具。 | – |
| pg\$1similarity.euclidean\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.euclidean\$1threshold | 設定 Euclidean 相似性量值使用的閾值。 | – |
| pg\$1similarity.euclidean\$1tokenizer | 設定 Euclidean 相似性量值的字符化工具。 | – |
| pg\$1similarity.hamming\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.hamming\$1threshold | 設定 Block 相似性指標使用的閾值。 | – |
| pg\$1similarity.jaccard\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.jaccard\$1threshold | 設定 Jaccard 相似性量值使用的閾值。 | – |
| pg\$1similarity.jaccard\$1tokenizer | 設定 Jaccard 相似性量值的字符化工具。 | – |
| pg\$1similarity.jaro\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.jaro\$1threshold | 設定 Jaro 相似性量值使用的閾值。 | – |
| pg\$1similarity.jarowinkler\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.jarowinkler\$1threshold | 設定 Jarowinkler 相似性量值使用的閾值。 | – |
| pg\$1similarity.levenshtein\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.levenshtein\$1threshold | 設定 Levenshtein 相似性量值使用的閾值。 | – |
| pg\$1similarity.matching\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.matching\$1threshold | 設定匹配係數相似性量值使用的閾值。 | – |
| pg\$1similarity.matching\$1tokenizer | 設定匹配係數相似性量值的字符化工具。 | – |
| pg\$1similarity.mongeelkan\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.mongeelkan\$1threshold | 設定 Monge-Elkan 相似性量值使用的閾值。 | – |
| pg\$1similarity.mongeelkan\$1tokenizer | 設定 Monge-Elkan 相似性量值的字符化工具。 | – |
| pg\$1similarity.nw\$1gap\$1penalty | 設定 Needleman-Wunsch 相似性量值使用的空位罰分。 | – |
| pg\$1similarity.nw\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.nw\$1threshold | 設定 Needle-Munsch 相似性量值使用的閾值。 | – |
| pg\$1similarity.overlap\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.overlap\$1threshold | 設定重疊係數相似性量值使用的閾值。 | – |
| pg\$1similarity.overlap\$1tokenizer | 設定重疊係數相似性量值的字符化工具。 | – |
| pg\$1similarity.qgram\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.qgram\$1threshold | 設定 Q-Gram 相似性量值使用的閾值。 | – |
| pg\$1similarity.qgram\$1tokenizer | 設定 Q-Gram 量值的字符化工具。 | – |
| pg\$1similarity.swg\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.swg\$1threshold | 設定 Smith-Waterman-Gotoh 相似性量值使用的閾值。 | – |
| pg\$1similarity.sw\$1is\$1normalized | 設定結果值是否標準化。 | – |
| pg\$1similarity.sw\$1threshold | 設定 Smith-Waterman 相似性量值使用的閾值。 | – |
| pg\$1stat\$1statements.max | 設定 pg\$1stat\$1statements 追蹤的陳述式數上限。 | – |
| pg\$1stat\$1statements.save | 儲存伺服器關閉期間的 pg\$1stat\$1list 統計數字。 | – |
| pg\$1stat\$1statements.track | 選擇 pg\$1stat\$1statements 追蹤哪些陳述式。 | – |
| pg\$1stat\$1statements.track\$1planning | 選擇 pg\$1stat\$1statements 是否追蹤計畫持續時間。 | – |
| pg\$1stat\$1statements.track\$1utility | 選擇 pg\$1stat\$1statements 是否追蹤實用程序命令。 | – |
| postgis.gdal\$1enabled\$1drivers | 啟用或停用 Postgres 9.3.5 及更新版本中搭配 PostGIS 使用的 GDAL 驅動程式。 | ENABLE\$1ALL |
| quote\$1all\$1identifiers | 產生 SQL 片段時為所有識別符新增引號。 | – |
| random\$1page\$1cost | 設定規劃器對於非循序擷取磁碟分頁的成本估算。 | – |
| rds.enable\$1memory\$1management | 改善 Aurora PostgreSQL 12.17、13.13、14.10、15.5 及更新版本的記憶體管理功能，可防止因可用記憶體不足而導致的穩定性問題和資料庫重新啟動。如需詳細資訊，請參閱[Aurora PostgreSQL 中的記憶體管理已改善限制](AuroraPostgreSQL.BestPractices.memory.management.md)。 | True |
| rds.force\$1admin\$1logging\$1level | 查看客户資料庫中 RDS 管理員使用者動作的日誌訊息。 | – |
| rds.log\$1retention\$1period | Amazon RDS 會刪除超過 N 分鐘的 PostgreSQL 日誌 | 4320 |
| rds.memory\$1allocation\$1guard | 改善 Aurora PostgreSQL 11.21、12.16、13.12、14.9、15.4 和較舊版本的記憶體管理功能，可防止因可用記憶體不足而導致的穩定性問題和資料庫重新啟動。如需詳細資訊，請參閱[Aurora PostgreSQL 中的記憶體管理已改善限制](AuroraPostgreSQL.BestPractices.memory.management.md)。 | False |
| rds.pg\$1stat\$1ramdisk\$1size | 統計資料 Ramdisk 的大小 (以 MB 為單位) 。若為非零值將設定 Ramdisk。 | 0 |
| rds.rds\$1superuser\$1reserved\$1connections | 設定為 rds\$1superusers 保留的連線槽數。此參數僅適用於第 15 版和更舊版本。如需詳細資訊，請參閱 PostgreSQL 文件[保留的連線](https://www.postgresql.org/docs/current/runtime-config-connection.html#GUC-RESERVED-CONNECTIONS)。 | 2 |
| rds.superuser\$1variables | 僅限進階使用者變數清單，我們提升了 rds\$1superuser 修改陳述式。 | session\$1replication\$1role |
| remove\$1temp\$1files\$1after\$1crash | 後端當機後移除暫存檔案。 | 0 |
| restart\$1after\$1crash | 後端當機後重新初始化伺服器。 | – |
| row\$1security | 啟用資料列安全性。 | – |
| search\$1path | 針對不符合結構描述的名稱設定結構描述搜尋順序。 | – |
| seq\$1page\$1cost | 設定規劃器對循序擷取磁碟分頁的成本估算。 | – |
| session\$1replication\$1role | 設定觸發器和重寫規則的工作階段行為。 | – |
| shared\$1buffers | (8kB) 設定伺服器所用的共用記憶體緩衝區數目。 | SUM(DBInstanceClassMemory/12038,-50003) |
| shared\$1preload\$1libraries | 列出要預先載入到伺服器的共用程式庫。 | pg\$1stat\$1statements |
| ssl\$1ca\$1file | SSL 伺服器授權檔案的位置。 | /rdsdbdata/rds-metadata/ca-cert.pem |
| ssl\$1cert\$1file | SSL 伺服器憑證檔案的位置。 | /rdsdbdata/rds-metadata/server-cert.pem |
| ssl\$1crl\$1dir | SSL 憑證撤銷清單目錄的位置。 | /rdsdbdata/rds-metadata/ssl\$1crl\$1dir/ |
| ssl\$1key\$1file | SSL 伺服器私有金鑰檔案的位置 | /rdsdbdata/rds-metadata/server-key.pem |
| standard\$1conforming\$1strings | 導致 ... 字串逐字地處理反斜線。 | – |
| statement\$1timeout | (毫秒) 設定任何陳述式允許的持續時間上限。 | – |
| stats\$1temp\$1directory | 將暫存統計數字檔案寫入指定目錄。 | /rdsdbdata/db/pg\$1stat\$1tmp |
| superuser\$1reserved\$1connections | 設定為進階使用者保留的連線槽數。 | 3 |
| synchronize\$1seqscans | 啟用已同步的循序掃描。 | – |
| tcp\$1keepalives\$1count | TCP 保持連線重新傳輸的數量上限 | – |
| tcp\$1keepalives\$1idle | (秒)發出 TCP 存留之間的時間。 | – |
| tcp\$1keepalives\$1interval | (秒) TCP 存留重新傳輸之間的時間。 | – |
| temp\$1buffers | (8kB) 設定每個工作階段所用的臨時緩衝區數上限。 | – |
| temp\$1file\$1limit | 限制指定 PostgreSQL 程序可用於暫存檔案的磁碟空間總量 (以 KB 為單位)，不包括用於明確暫存資料表的空間 | -1 |
| temp\$1tablespaces | 設定要用於暫存資料表和排序檔案的資料表空間。 | – |
| track\$1activities | 收集有關執行命令的資訊。 | – |
| track\$1activity\$1query\$1size | 設定為 pg\$1stat\$1activity.current\$1query 保留的大小 (以位元組為單位)。 | 4096 |
| track\$1counts | 收集資料庫活動的統計資訊。 | – |
| track\$1functions | 收集資料庫活動的功能層級統計資訊。 | pl |
| track\$1io\$1timing | 收集資料庫輸入/輸出活動的計時統計數字。 | 1 |
| transform\$1–\$1equals | 將 expr=– 視為 IS –。 | – |
| update\$1process\$1title | 更新程序標題以顯示作用中的 SQL 命令。 | – |
| wal\$1receiver\$1status\$1interval | (秒) 設定向主伺服器報告 WAL 接收器狀態之間的間隔上限。 | – |
| work\$1mem | (kB) 設定要用於查詢工作空間的記憶體上限。 | – |
| xmlbinary | 設定有多少二進位值要在 XML 中編碼。 | – |
| xmloption | 設定要將明確剖析和序列化作業中的 XML 資料視為文件或內容片段。 | – |
# Amazon Aurora PostgreSQL 等待事件
以下是 Aurora PostgreSQL 的常見等待事件。若要進一步了解等待事件和調整 Aurora PostgreSQL 資料庫叢集，請參閱 [調校 Aurora PostgreSQL 的等待事件](AuroraPostgreSQL.Tuning.md)。
**Activity:ArchiverMain**
封存程序正在等待活動。
**Activity:AutoVacuumMain**
自動資料清理啟動器程序正在等待活動。
**Activity:BgWriterHibernate**
等待活動時，背景寫入器程序正在休眠。
**Activity:BgWriterMain**
背景寫入器程序正在等待活動。
**Activity:CheckpointerMain**
檢查點指標程序正在等待活動。
**Activity:LogicalApplyMain**
邏輯複寫套用程序正在等待活動。
**Activity:LogicalLauncherMain**
邏輯複寫啟動器程序正在等待活動。
**Activity:PgStatMain**
統計資料收集器程序正在等待活動。
**Activity:RecoveryWalAll**
程序正在等待復原時來自串流的預寫日誌 (WAL)。
**Activity:RecoveryWalStream**
啟動程序正在等待要在串流復原期間送達的預寫日誌 (WAL)。
**Activity:SysLoggerMain**
syslogger 程序正在等待活動。
**Activity:WalReceiverMain**
預寫日誌 (WAL) 接收器程序正在等待活動。
**Activity:WalSenderMain**
預寫日誌 (WAL) 傳送器程序正在等待活動。
**Activity:WalWriterMain**
預寫日誌 (WAL) 寫入器程序正在等待活動。
**BufferPin:BufferPin**
程序正在等待獲取緩衝區上的專用 Pin。
**Client:GSSOpenServer**
在建立一般安全服務應用程式界面 (GSSAPI) 工作階段時，程序正在等待從用戶端讀取資料。
**Client:ClientRead**
後端程序正在等待從 PostgreSQL 用戶端接收資料。如需詳細資訊，請參閱[Client:ClientRead](apg-waits.clientread.md)。
**Client:ClientWrite**
後端程序正在等待將更多資料傳送到 PostgreSQL 用戶端。如需詳細資訊，請參閱[Client:ClientWrite](apg-waits.clientwrite.md)。
**Client:LibPQWalReceiverConnect**
程序正在預寫日誌 (WAL) 接收器中等待，以建立遠端伺服器的連線。
**Client:LibPQWalReceiverReceive**
程序正在預寫日誌 (WAL) 接收器中等待，以從遠端伺服器接收資料。
**Client:SSLOpenServer**
程序在嘗試連線時等待 Secure Sockets Layer (SSL)。
**Client:WalReceiverWaitStart**
程序正在等待啟動程序傳送初始資料以進行串流複寫。
**Client:WalSenderWaitForWAL**
程序正在等待 WAL 傳送器程序中清空預寫日誌 (WAL)。
**Client:WalSenderWriteData**
在處理來自 WAL 傳送器程序中預寫日誌 (WAL) 接收器的回覆時，程序正在等待任何活動。
**CPU**
後端程序處於作用中或正在等待 CPU。如需詳細資訊，請參閱[CPU](apg-waits.cpu.md)。
**Extension:extension**
後端程序正在等待擴充功能或模組定義的條件。
**IO:AuroraEnhancedLogicalWALRead**
後端程序會從變更資料擷取 (CDC) 磁碟區擷取日誌記錄。
**IO:AuroraOptimizedReadsCacheRead**
程序正在等待從 Optimized Reads 階層式快取進行讀取，因為該頁面在共享記憶體中不可用。
**IO:AuroraOptimizedReadsCacheSegmentTruncate**
程序正在等待將 Optimized Reads 階層式快取區段檔案進行截斷。
**IO:AuroraOptimizedReadsCacheWrite**
背景寫入器程序正在等待寫入 Optimized Reads 階層式快取。
**IO:AuroraStorageLogAllocate**
工作階段正在配置中繼資料並準備交易日誌寫入。
**IO:BufFileRead**
當作業需要的記憶體超過工作記憶體參數所定義的數量時，引擎會在磁碟上建立暫存檔案。作業從暫存檔案讀取時，就會發生此等待事件。如需詳細資訊，請參閱[IO:BufFileRead 和 IO:BufFileWrite](apg-waits.iobuffile.md)。
**IO:BufFileWrite**
當作業需要的記憶體超過工作記憶體參數所定義的數量時，引擎會在磁碟上建立暫存檔案。當作業寫入至暫存檔案時，就會發生此等待事件。如需詳細資訊，請參閱[IO:BufFileRead 和 IO:BufFileWrite](apg-waits.iobuffile.md)。
**IO:ControlFileRead**
程序正在等待從 `pg_control` 檔案進行讀取。
**IO:ControlFileSync**
程序正在等待 `pg_control` 檔案達到持久的儲存。
**IO:ControlFileSyncUpdate**
程序正在等待 `pg_control` 檔案的更新以達到持久的儲存。
**IO: 控制檔案寫入**
程序正在等待寫入至 `pg_control` 檔案。
**IO:ControlFileWriteUpdate**
程序正在等待寫入以更新 `pg_control` 檔案。
**IO:CopyFileRead**
程序正在檔案複製作業期間等待讀取。
**IO:CopyFileWrite**
程序正在檔案複製作業期間等待寫入。
**IO:DataFileExtend**
程序正在等待關聯資料檔案擴充。
**IO:DataFileFlush**
程序正在等待關聯資料檔案達到持久的儲存。
**IO:DataFileImmediateSync**
程序正在等待關聯資料檔案立即同步到持久的儲存。
**IO:DataFilePrefetch**
程序正在等待從關聯資料檔案進行非同步預先擷取。
**IO:DataFileSync**
程序正在等待關聯資料檔案的變更，以達到持久的儲存。
**IO:DataFileRead**
後端程序已嘗試在共用緩衝區中尋找一個頁面，但沒有找到它，所以從儲存中讀取它。如需詳細資訊，請參閱[IO:DataFileRead](apg-waits.iodatafileread.md)。
**IO:DataFileTruncate**
程序正在等待關聯資料檔案進行截斷。
**IO:DataFileWrite**
程序正在等待寫入至關聯資料檔案。
**IO:DSMFillZeroWrite**
程序正在等待將零位元組寫入至動態共用記憶體備份檔案。
**IO:LockFileAddToDataDirRead**
在將一行新增至資料目錄鎖定檔案時，程序正在等待讀取。
**IO:LockFileAddToDataDirSync**
在將一行新增到資料目錄鎖定檔案時，程序正在等待資料達到持久的儲存。
**IO:LockFileAddToDataDirWrite**
在將一行新增至資料目錄鎖定檔案時，程序正在等待寫入。
**IO:LockFileCreateRead**
建立資料目錄鎖定檔案時，程序正在等待讀取。
**IO:LockFileCreateSync**
在建立資料目錄鎖定檔案時，程序正在等待資料達到持久的儲存。
**IO:LockFileCreateWrite**
在建立資料目錄鎖定檔案時，程序正在等待寫入。
**IO:LockFileReCheckDataDirRead**
在重新檢查資料目錄鎖定檔案期間，程序正在等待讀取。
**IO:LogicalRewriteCheckpointSync**
在檢查點期間，程序正在等待邏輯重寫映射達到持久的儲存。
**IO:LogicalRewriteMappingSync**
在邏輯重寫期間，程序正在等待映射資料達到持久的儲存。
**IO:LogicalRewriteMappingWrite**
在邏輯重寫期間，程序正在等待映射資料的寫入。
**IO:LogicalRewriteSync**
程序正在等待邏輯重寫映射達到持久的儲存。
**IO:LogicalRewriteTruncate**
在邏輯重寫期間，程序正在等待映射資料的截斷。
**IO:LogicalRewriteWrite**
程序正在等待邏輯重寫映射的寫入。
**IO:RelationMapRead**
程序正在等待關聯映射檔案的讀取。
**IO:RelationMapSync**
程序正在等待關聯映射檔案達到持久的儲存。
**IO:RelationMapWrite**
程序正在等待寫入至關聯映射檔案。
**IO:ReorderBufferRead**
在重新排序緩衝區管理期間，程序正在等待讀取。
**IO:ReorderBufferWrite**
在重新排序緩衝區管理期間，程序正在等待寫入。
**IO:ReorderLogicalMappingRead**
在重新排序緩衝區管理期間，程序正在等待邏輯映射的讀取。
**IO:ReplicationSlotRead**
程序正在等待從複寫插槽控制檔案讀取。
**IO:ReplicationSlotRestoreSync**
在將複寫插槽控制檔案還原到記憶體時，程序正在等待其達到持久的儲存。
**IO:ReplicationSlotSync**
程序正在等待複寫插槽控制檔案達到持久的儲存。
**IO:ReplicationSlotWrite**
程序正在等待寫入至複寫插槽控制檔案。
**IO:SLRUFlushSync**
在檢查點或資料庫關閉期間，程序正在等待簡單的最近最少使用 (SLRU) 資料達到持久的儲存。
**IO:SLRURead**
程序正在等待讀取簡單的最近最少使用 (SLRU) 頁面。
**IO:SLRUSync**
程序正在等待簡單的最近最少使用 (SLRU) 資料，在頁面寫入後達到持久的儲存。
**IO:SLRUWrite**
程序正在等待寫入簡單的最近最少使用 (SLRU) 頁面。
**IO:SnapbuildRead**
程序正在等待讀取序列化的歷史目錄快照。
**IO:SnapbuildSync**
程序正在等待序列化的歷史目錄快照達到持久的儲存。
**IO:SnapbuildWrite**
程序正在等待寫入序列化的歷史目錄快照。
**IO:TimelineHistoryFileSync**
程序正在等待透過串流複寫接收的時間軸歷史記錄檔案達到持久的儲存。
**IO:TimelineHistoryFileWrite**
程序正在等待寫入透過串流複寫接收的時間軸歷史記錄檔案。
**IO:TimelineHistoryRead**
程序正在等待讀取時間軸歷史記錄檔案。
**IO:TimelineHistorySync**
程序正在等待新建立的時間軸歷史記錄檔案達到持久的儲存。
**IO:TimelineHistoryWrite**
程序正在等待寫入新建立的時間軸歷史記錄檔案。
**IO:TwophaseFileRead**
程序正在等待讀取兩個階段狀態檔案。
**IO:TwophaseFileSync**
程序正在等待兩個階段狀態檔案達到持久的儲存。
**IO:TwophaseFileWrite**
程序正在等待寫入兩個階段狀態檔案。
**IO:WALBootstrapSync**
在自舉期間，程序正在等待預寫日誌 (WAL) 達到持久的儲存。
**IO:WALBootstrapWrite**
在自舉期間，程序正在等待寫入預寫日誌 (WAL) 頁面。
**IO:WALCopyRead**
複製現有的區段建立新的預寫日誌 (WAL) 區段時，程序正在等待讀取。
**IO:WALCopySync**
程序正在等待藉由複製現有區段所建立的新預寫日誌 (WAL) 區段達到持久的儲存。
**IO:WALCopyWrite**
複製現有的區段建立新的預寫日誌 (WAL) 區段時，程序正在等待寫入。
**IO:WALInitSync**
程序正在等待新初始化的預寫日誌 (WAL) 檔案達到持久的儲存。
**IO:WALInitWrite**
初始化新的預寫日誌 (WAL) 檔案時，程序正在等待寫入。
**IO:WALRead**
程序正在等待從預寫日誌 (WAL) 檔案讀取。
**IO:WALSenderTimelineHistoryRead**
在 WAL 傳送器時間軸命令期間，程序正在等待從時間軸歷史記錄檔案讀取。
**IO:WALSync**
程序正在等待預寫日誌 (WAL) 檔案達到持久的儲存。
**IO:WALSyncMethodAssign**
在指派新的預寫日誌 (WAL) 同步方法時，程序正在等待資料達到持久的儲存。
**IO:WALWrite**
程序正在等待寫入至預寫日誌 (WAL) 檔案。
**IO:XactSync**
後端程序正在等待 Aurora 儲存子系統確認一般交易的遞交，或是預備交易的遞交或回復。如需詳細資訊，請參閱[IO:XactSync](apg-waits.xactsync.md)。
**IPC:AuroraLogicalSchemaUpdate**
兩個後端程序正嘗試將相同的項目插入結構描述快取。一個程序會繼續，而另一個程序會等待其完成。
**IPC:AuroraOptimizedReadsCacheWriteStop**
程序正等待背景寫入器停止寫入最佳化讀取階層式快取。
**IPC:BackupWaitWalArchive**
程序正在等待備份所需的預寫日誌 (WAL) 檔案成功封存。
**IPC:BgWorkerShutdown**
程序正在等待背景工作者關閉。
**IPC:BgWorkerStartup**
程序正在等待背景工作者啟動。
**IPC: 建立頁面**
程序正在等待繼續平行 B 型樹狀目錄掃描所需的頁碼變成可用。
**IPC:CheckpointDone**
程序正在等待檢查點完成。
**IPC:CheckpointStart**
程序正在等待檢查點啟動。
**IPC:ClogGroupUpdate**
程序正在等待群組領導者在交易結束時更新交易狀態。
**IPC:DamRecordTxAck**
後端程序已產生資料庫活動串流事件，而且正在等待事件變成持久的。如需詳細資訊，請參閱[IPC:DamRecordTxAck](apg-waits.ipcdamrecordtxac.md)。
**IPC:ExecuteGather**
在執行蒐集計劃節點時，程序正在等待來自子程序的活動。
**IPC:Hash/Batch/Allocating**
程序正在等待選定的平行雜湊參與者來配置雜湊表。
**IPC:Hash/Batch/Electing**
程序正在選擇平行雜湊參與者來配置雜湊表。
**IPC:Hash/Batch/Loading**
程序正在等待其他平行雜湊參與者完成載入雜湊表。
**IPC:Hash/Build/Allocating**
程序正在等待選定的平行雜湊參與者來配置初始雜湊表。
**IPC:Hash/Build/Electing**
程序正在選擇平行雜湊參與者來配置初始雜湊表。
**IPC:Hash/Build/HashingInner**
程序正在等待其他平行雜湊參與者完成內部關聯的雜湊。
**IPC:Hash/Build/HashingOuter**
程序正在等待其他平行雜湊參與者完成外部關聯的分割。
**IPC:Hash/GrowBatches/Allocating**
程序正在等待選定的平行雜湊參與者配置更多批次。
**IPC:Hash/GrowBatches/Deciding**
程序正在選擇平行雜湊參與者來決定未來的批次增長。
**IPC:Hash/GrowBatches/Electing**
程序正在選擇平行雜湊參與者來配置更多批次。
**IPC:Hash/GrowBatches/Finishing**
程序正在等待選定的平行雜湊參與者來決定未來的批次增長。
**IPC:Hash/GrowBatches/Repartitioning**
程序正在等待其他平行雜湊參與者完成重新分割。
**IPC:Hash/GrowBuckets/Allocating**
程序正在等待選定的平行雜湊參與者完成配置更多的儲存貯體。
**IPC:Hash/GrowBuckets/Electing**
程序正在選擇一個平行雜湊參與者來配置更多的儲存貯體。
**IPC:Hash/GrowBuckets/Reinserting**
程序正在等待其他平行雜湊參與者完成將元組插入到新的儲存貯體。
**IPC:HashBatchAllocate**
程序正在等待選定的平行雜湊參與者來配置雜湊表。
**IPC:HashBatchElect**
程序正在等待選擇平行雜湊參與者來配置雜湊表。
**IPC:HashBatchLoad**
程序正在等待其他平行雜湊參與者完成載入雜湊表。
**IPC:HashBuildAllocate**
程序正在等待選定的平行雜湊參與者來配置初始雜湊表。
**IPC:HashBuildElect**
程序正在等待選擇平行雜湊參與者來配置初始雜湊表。
**IPC:HashBuildHashInner**
程序正在等待其他平行雜湊參與者完成內部關聯的雜湊。
**IPC:'HashBuildHashOuter**
程序正在等待其他平行雜湊參與者完成外部關聯的分割。
**IPC:HashGrowBatchesAllocate**
程序正在等待選定的平行雜湊參與者配置更多批次。
**IPC:'HashGrowBatchesDecide**
程序正在等待選擇平行雜湊參與者來決定未來的批次增長。
**IPC:HashGrowBatchesElect**
程序正在等待選擇平行雜湊參與者來配置更多批次。
**IPC:HashGrowBatchesFinish**
程序正在等待選定的平行雜湊參與者來決定未來的批次增長。
**IPC:HashGrowBatchesRepartition**
程序正在等待其他平行雜湊參與者完成重新分割。
**IPC:HashGrowBucketsAllocate**
程序正在等待選定的平行雜湊參與者完成配置更多的儲存貯體。
**IPC:HashGrowBucketsElect**
程序正在等待選擇平行雜湊參與者來配置更多的儲存貯體。
**IPC:HashGrowBucketsReinsert**
程序正在等待其他平行雜湊參與者完成將元組插入到新的儲存貯體。
**IPC:LogicalSyncData**
程序正在等待邏輯複寫遠端伺服器傳送資料，以進行初始資料表同步。
**IPC:LogicalSyncStateChange**
程序正在等待邏輯複寫遠端伺服器變更狀態。
**IPC:MessageQueueInternal**
程序正在等待另一個程序附加到共用訊息佇列。
**IPC:MessageQueuePutMessage**
程序正在等待將通訊協定訊息寫入至共用訊息佇列。
**IPC:MessageQueueReceive**
程序正在等待從共用訊息佇列接收位元組。
**IPC:MessageQueueSend**
程序正在等待將位元組傳送至共用訊息佇列。
**IPC:ParallelBitmapScan**
程序正在等待平行點陣圖掃描初始化。
**IPC:ParallelCreateIndexScan**
程序正在等待 CREATE INDEX 工作者完成堆積掃描。
**IPC:ParallelFinish**
程序正在等待平行工作者完成運算。
**IPC:ProcArrayGroupUpdate**
程序正等待群組領導者在交易結束時清除交易 ID。
**IPC:ProcSignalBarrier**
程序正在等待所有後端處理屏障事件。
**IPC:Promote**
程序正在等待待命提升。
**IPC:RecoveryConflictSnapshot**
程序正在等待解決復原衝突以進行清理清除。
**IPC:RecoveryConflictTablespace**
程序正在等待解決復原衝突，以捨棄資料表空間。
**IPC:RecoveryPause**
程序正在等待復原繼續進行。
**IPC:ReplicationOriginDrop**
程序正在等待複寫來源變成非作用中，以便可以將其捨棄。
**IPC:ReplicationSlotDrop**
程序正在等待複寫插槽變成非作用中，以便可以將其捨棄。
**IPC:SafeSnapshot**
程序正在等待取得 READ ONLY DEFERRABLE 交易的有效快照。
**IPC:SyncRep**
在同步複寫期間，程序正在等待遠端伺服器的確認。
**IPC:XactGroupUpdate**
程序正等待群組領導者在交易結束時更新交易狀態。
**Lock:advisory**
後端程序已請求建議鎖定，並正在等待它。如需詳細資訊，請參閱[Lock:advisory](apg-waits.lockadvisory.md)。
**Lock:extend**
後端程序正在等待釋放鎖定，以便它可以延伸關聯。此鎖定是必要的，因為一次只有一個後端程序可以延伸關聯。如需詳細資訊，請參閱[Lock:extend](apg-waits.lockextend.md)。
**Lock:frozenid**
程序正在等待更新 `pg_database.datfrozenxid` 和 `pg_database.datminmxid`。
**Lock:object**
程序正在等待對非關聯式資料庫物件取得鎖定。
**Lock:page**
程序正在等待對關聯的頁面取得鎖定。
**Lock:Relation**
後端程序正在等待對另一個交易所鎖定的關聯取得鎖定。如需詳細資訊，請參閱[Lock:Relation](apg-waits.lockrelation.md)。
**Lock:spectoken**
程序正在等待取得推測性插入鎖定。
**Lock:speculative token**
程序正在等待取得推測性插入鎖定。
**Lock:transactionid**
交易正在等待資料列層級鎖定。如需詳細資訊，請參閱[Lock:transactionid](apg-waits.locktransactionid.md)。
**Lock:tuple**
在另一個後端程序對元組保有衝突鎖定時，後端程序正在等待對相同的元組取得鎖定。如需詳細資訊，請參閱[Lock:tuple](apg-waits.locktuple.md)。
**Lock:userlock**
程序正在等待取得使用者鎖定。
**Lock:virtualxid**
程序正在等待取得虛擬交易 ID 鎖定。
**LWLock:AddinShmemInit**
程序正在等待管理共用記憶體中擴充功能的空間配置。
**LWLock:AddinShmemInitLock**
程序正在等待管理共用記憶體中的空間配置。
**LWLock:async**
程序正在等待非同步 (通知) 緩衝區上的輸入/輸出。
**LWLock:AsyncCtlLock**
程序正在等待讀取或更新共用通知狀態。
**LWLock:AsyncQueueLock**
程序正在等待讀取或更新通知訊息。
**LWLock:AuroraOptimizedReadsCacheMapping**
程序正在等待將資料區塊與 Optimized Reads 階層式快取中的頁面建立關聯。
**LWLock:AutoFile**
程序正在等待更新 `postgresql.auto.conf` 檔案。
**LWLock:AutoFileLock**
程序正在等待更新 `postgresql.auto.conf` 檔案。
**LWLock:Autovacuum**
程序正在等待讀取或更新自動資料清理工作者的目前狀態。
**LWLock:AutovacuumLock**
自動資料清理工作者或啟動器正在等待更新或讀取自動資料清理工作者的目前狀態。
**LWLock:AutovacuumSchedule**
程序正在等待確保為了自動資料清理而選取的資料表仍然需要清理。
**LWLock:AutovacuumScheduleLock**
程序正在等待確保其為了清理而選取的資料表仍然需要清理。
**LWLock:BackendRandomLock**
程序正在等待產生亂數。
**LWLock:BackgroundWorker**
程序正在等待讀取或更新背景工作者狀態。
**LWLock:BackgroundWorkerLock**
程序正在等待讀取或更新背景工作者狀態。
**LWLock:BtreeVacuum**
程序正在等待讀取或更新 B 型樹狀結構索引的清理相關資訊。
**LWLock:BtreeVacuumLock**
程序正在等待讀取或更新 B 型樹狀結構索引的清理相關資訊。
**LWLock:buffer\$1content**
後端程序正在等待對共用記憶體緩衝區的內容取得輕量型鎖定。如需詳細資訊，請參閱[LWLock:buffer\$1content (BufferContent)](apg-waits.lockbuffercontent.md)。
**LWLock:buffer\$1mapping**
後端程序正在等待將資料區塊與共用緩衝集區中的緩衝區建立關聯。如需詳細資訊，請參閱[LWLock:buffer\$1mapping](apg-waits.lwl-buffer-mapping.md)。
**LWLock:BufferIO**
後端程序想要將頁面讀入共用記憶體中。程序正在等待其他程序完成頁面的輸入/輸出。如需詳細資訊，請參閱[LWLock:BufferIO (IPC:BufferIO)](apg-waits.lwlockbufferio.md)。
**LWLock:Checkpoint**
程序正在等待開始檢查點。
**LWLock:CheckpointLock**
程序正在等待執行檢查點。
**LWLock:CheckpointerComm**
程序正在等待管理 `fsync` 請求。
**LWLock:CheckpointerCommLock**
程序正在等待管理 `fsync` 請求。
**LWLock:clog**
程序正在等待 Clog (交易狀態) 緩衝區上的輸入/輸出。
**LWLock:CLogControlLock**
程序正在等待讀取或更新交易狀態。
**LWLock:CLogTruncationLock**
程序正在等待執行 `txid_status` 或更新其可用的最舊交易 ID。
**LWLock:commit\$1timestamp**
程序正在等待遞交時間戳記緩衝區上的輸入/輸出。
**LWLock:CommitTs**
程序正在等待讀取或更新針對交易遞交時間戳記設定的最後一個值。
**LWLock:CommitTsBuffer**
程序正在等待簡單的最近最少使用 (SLRU) 緩衝區上的輸入/輸出，以取得遞交時間戳記。
**LWLock:CommitTsControlLock**
程序正在等待讀取或更新交易遞交時間戳記。
**LWLock:CommitTsLock**
程序正在等待讀取或更新針對交易時間戳記設定的最後一個值。
**LWLock:CommitTsSLRU**
程序正在等待存取簡單的最近最少使用 (SLRU) 快取，以取得遞交時間戳記。
**LWLock:ControlFile**
程序正在等待讀取或更新 `pg_control` 檔案，或建立新的預寫日誌 (WAL) 檔案。
**LWLock:ControlFileLock**
程序正在等待讀取或更新控制檔案，或建立新的預寫日誌 (WAL) 檔案。
**LWLock:DynamicSharedMemoryControl**
程序正在等待讀取或更新動態共用記憶體配置資訊。
**LWLock:DynamicSharedMemoryControlLock**
程序正在等待讀取或更新動態共用記憶體狀態。
**LWLock:lock\$1manager**
後端程序正在等待新增或檢查後端程序的鎖定。或者它正在等待加入或退出平行查詢所使用的鎖定群組。如需詳細資訊，請參閱[LWLock:lock\$1manager](apg-waits.lw-lock-manager.md)。
**LWLock:LockFastPath**
程序正在等待讀取或更新程序的快速路徑鎖定資訊。
**LWLock:LogicalRepWorker**
程序正在等待讀取或更新邏輯複寫工作者的狀態。
**LWLock:LogicalRepWorkerLock**
程序正在等待邏輯複寫工作者上的動作完成。
**LWLock:LogicalSchemaCache**
程序已修改結構描述快取。
**LWLock:multixact\$1member**
程序正在等待 multixact\$1member 緩衝區上的輸入/輸出。
**LWLock:multixact\$1offset**
程序正在等待 multixact 位移緩衝區上的輸入/輸出。
**LWLock:MultiXactGen**
程序正在等待讀取或更新共用 multixact 狀態。
**LWLock:MultiXactGenLock**
程序正在等待讀取或更新共用 multixact 狀態。
**LWLock:MultiXactMemberBuffer**
程序正在等待簡單的最近最少使用 (SLRU) 緩衝區上的輸入/輸出，以取得 multixact 成員。如需詳細資訊，請參閱[LWLock:MultiXact](apg-waits.lwlockmultixact.md)。
**LWLock:MultiXactMemberControlLock**
程序正在等待讀取或更新 multixact 成員映射。
**LWLock:MultiXactMemberSLRU**
程序正在等待存取簡單的最近最少使用 (SLRU) 快取，以取得 multixact 成員。如需詳細資訊，請參閱[LWLock:MultiXact](apg-waits.lwlockmultixact.md)。
**LWLock:MultiXactOffsetBuffer**
程序正在等待簡單的最近最少使用 (SLRU) 緩衝區上的輸入/輸出，以取得 multixact 位移。如需詳細資訊，請參閱[LWLock:MultiXact](apg-waits.lwlockmultixact.md)。
**LWLock:MultiXactOffsetControlLock**
程序正在等待讀取或更新 multixact 位移映射。
**LWLock:MultiXactOffsetSLRU**
程序正在等待存取簡單的最近最少使用 (SLRU) 快取，以取得 multixact 位移。如需詳細資訊，請參閱[LWLock:MultiXact](apg-waits.lwlockmultixact.md)。
**LWLock:MultiXactTruncation**
程序正在等待讀取或截斷 multixact 資訊。
**LWLock:MultiXactTruncationLock**
程序正在等待讀取或截斷 multixact 資訊。
**LWLock:NotifyBuffer**
程序正在等待簡單的最近最少使用 (SLRU) 緩衝區上的輸入/輸出，以取得 NOTIFY 通知。
**LWLock:NotifyQueue**
程序正在等待讀取或更新 NOTIFY 訊息。
**LWLock:NotifyQueueTail**
程序正在等待更新對 NOTIFY 訊息儲存的限制。
**LWLock:NotifyQueueTailLock**
程序正在等待更新對通知訊息儲存的限制。
**LWLock:NotifySLRU**
程序正在等待存取簡單的最近最少使用 (SLRU) 快取，以取得 NOTIFY 訊息。
**LWLock:OidGen**
程序正在等待配置新的物件 ID (OID)。
**LWLock:OidGenLock**
程序正在等待配置或指派物件 ID (OID)。
**LWLock:oldserxid**
程序正在等待 oldserxid 緩衝區上的輸入/輸出。
**LWLock:OldSerXidLock**
程序正在等待讀取或記錄衝突的序列化交易。
**LWLock:OldSnapshotTimeMap**
程序正在等待讀取或更新舊的快照控制資訊。
**LWLock:OldSnapshotTimeMapLock**
程序正在等待讀取或更新舊的快照控制資訊。
**LWLock:parallel\$1append**
在平行附加計劃執行期間，程序正在等待選擇下一個子計劃。
**LWLock:parallel\$1hash\$1join**
在平行雜湊計劃執行期間，程序正在等待配置或交換記憶體區塊或更新計數器。
**LWLock:parallel\$1query\$1dsa**
程序正在等待鎖定動態共用記憶體配置，以進行平行查詢。
**LWLock:ParallelAppend**
在平行附加計劃執行期間，程序正在等待選擇下一個子計劃。
**LWLock:ParallelHashJoin**
在平行雜湊聯結的計劃執行期間，程序正在等待同步工作者。
**Lwlock:ParallelQueryDSA**
程序正在等待動態共用記憶體配置，以進行平行查詢。
**Lwlock:PerSessionDSA**
程序正在等待動態共用記憶體配置，以進行平行查詢。
**Lwlock:PerSessionRecordType**
程序正在等待存取有關複合類型的平行查詢資訊。
**Lwlock:PerSessionRecordTypmod**
程序正在等待存取有關識別匿名記錄類型之類型修飾詞的平行查詢資訊。
**Lwlock:PerXactPredicateList**
程序正在等待存取目前可序列化交易在平行查詢期間保留的述詞鎖定清單。
**Lwlock:predicate\$1lock\$1manager**
程序正在等待新增或檢查述詞鎖定資訊。
**Lwlock:PredicateLockManager**
程序正在等待存取可序列化交易所使用的述詞鎖定資訊。
**Lwlock:proc**
程序正在等待讀取或更新快速路徑鎖定資訊。
**LWLock:ProcArray**
程序正在等待存取共用的每個程序資料結構 (通常，用來取得快照或報告工作階段的交易 ID)。
**LWLock:ProcArrayLock**
程序正在等待取得快照或在交易結束時清除交易 ID。
**LWLock:RelationMapping**
程序正在等待讀取或更新 `pg_filenode.map` 檔案 (用來追蹤特定系統目錄的檔案節點指派)。
**LWLock:RelationMappingLock**
程序正在等待更新用來存放目錄至檔案節點映射的關聯映射檔案。
**LWLock:RelCacheInit**
程序正在等待讀取或更新 `pg_internal.init` 檔案 (關聯快取初始化檔案)。
**LWLock:RelCacheInitLock**
程序正在等待讀取或寫入關聯快取初始化檔案。
**LWLock:replication\$1origin**
程序正在等待讀取或更新複寫進度。
**LWLock:replication\$1slot\$1io**
程序正在等待複寫插槽上的輸入/輸出。
**LWLock:ReplicationOrigin**
程序正在等待建立、捨棄或使用複寫來源。
**LWLock:ReplicationOriginLock**
程序正在等待設定、捨棄或使用複寫來源。
**LWLock:ReplicationOriginState**
程序正在等待讀取或更新某個複寫來源的進度。
**LWLock:ReplicationSlotAllocation**
程序正在等待配置或釋出複寫插槽。
**LWLock:ReplicationSlotAllocationLock**
程序正在等待配置或釋出複寫插槽。
**LWLock:ReplicationSlotControl**
程序正在等待讀取或更新複寫插槽狀態。
**LWLock:ReplicationSlotControlLock**
程序正在等待讀取或更新複寫插槽狀態。
**LWLock:ReplicationSlotIO**
程序正在等待複寫插槽上的輸入/輸出。
**LWLock:SerialBuffer**
程序正在等待簡單的最近最少使用 (SLRU) 緩衝區上的輸入/輸出，以取得可序列化的交易衝突。
**LWLock:SerializableFinishedList**
程序正在等待存取已完成的可序列化交易清單。
**LWLock:SerializableFinishedListLock**
程序正在等待存取已完成的可序列化交易清單。
**LWLock:SerializablePredicateList**
程序正在等待存取可序列化交易所保留的述詞鎖定清單。
**LWLock:SerializablePredicateLockListLock**
程序正在等待對可列化交易所保留的鎖定清單執行作業。
**LWLock:SerializableXactHash**
程序正在等待讀取或更新可序列化交易的相關資訊。
**LWLock:SerializableXactHashLock**
程序正在等待擷取或存放可序列化交易的相關資訊。
**LWLock:SerialSLRU**
程序正在等待存取簡單的最近最少使用 (SLRU) 快取，以取得可序列化的交易衝突。
**LWLock:SharedTidBitmap**
在平行點陣圖索引掃描期間，程序正在等待存取共用的元組識別符 (TID) 點陣圖。
**LWLock:SharedTupleStore**
程序正在等待在平行查詢期間存取共用的元組存放區。
**LWLock:ShmemIndex**
程序正在等待尋找或配置共用記憶體中的空間。
**LWLock:ShmemIndexLock**
程序正在等待尋找或配置共用記憶體中的空間。
**LWLock:SInvalRead**
程序正在等待從共用目錄失效佇列中擷取訊息。
**LWLock:SInvalReadLock**
程序正在等待從共用失效佇列中擷取或移除訊息。
**LWLock:SInvalWrite**
程序正在等待將訊息新增至共用目錄失效佇列。
**LWLock:SInvalWriteLock**
程序正在等待在共用失效佇列中新增訊息。
**LWLock:SyncRep**
程序正在等待讀取或更新同步複寫狀態的相關資訊。
**LWLock:SyncRepLock**
程序正在等待讀取或更新同步複本的相關資訊。
**LWLock:SyncScan**
程序正在等待選取同步表格掃描的起始位置。
**LWLock:SyncScanLock**
程序正在等待取得表格上掃描的起始位置，以進行同步掃描。
**LWLock:TablespaceCreate**
程序正在等待建立或捨棄資料表空間。
**LWLock:TablespaceCreateLock**
程序正在等待建立或捨棄資料表空間。
**LWLock:tbm**
程序正在等待樹狀點陣圖 (TBM) 上的共用疊代鎖定。
**LWLock:TwoPhaseState**
程序正在等待讀取或更新預備交易的狀態。
**LWLock:TwoPhaseStateLock**
程序正在等待讀取或更新預備交易的狀態。
**LWLock:wal\$1insert**
程序正在等待將預寫日誌 (WAL) 插入到記憶體緩衝區。
**LWLock:WALBufMapping**
程序正在等待取代預寫日誌 (WAL) 緩衝區中的頁面。
**LWLock:WALBufMappingLock**
程序正在等待取代預寫日誌 (WAL) 緩衝區中的頁面。
**LWLock:WALInsert**
程序正在等待將預寫日誌 (WAL) 資料插入到記憶體緩衝區。
**LWLock:WALWrite**
程序正在等待預寫日誌 (WAL) 緩衝區寫入至磁碟。
**LWLock:WALWriteLock**
程序正在等待預寫日誌 (WAL) 緩衝區寫入至磁碟。
**LWLock:WrapLimitsVacuum**
程序正在等待更新對交易 ID 和 multixact 耗用的限制。
**LWLock:WrapLimitsVacuumLock**
程序正在等待更新對交易 ID 和 multixact 耗用的限制。
**LWLock:XactBuffer**
程序正在等待簡單的最近最少使用 (SLRU) 緩衝區上的輸入/輸出，以取得交易狀態。
**LWLock:XactSLRU**
程序正在等待存取簡單的最近最少使用 (SLRU) 快取，以取得交易狀態。
**LWLock:XactTruncation**
程序正在等待執行 pg\$1xact\$1status 或更新其可用的最舊交易 ID。
**LWLock:XidGen**
程序正在等待配置新的交易 ID。
**LWLock:XidGenLock**
程序正在等待配置或指派交易 ID。
**Timeout:BaseBackupThrottle**
在基礎備份期間，若調節活動，程序即會等待。
**Timeout:PgSleep**
後端程序已呼叫 pg\$1sleep 函數，並且正在等待睡眠逾時到期。如需詳細資訊，請參閱[Timeout:PgSleep](apg-waits.timeoutpgsleep.md)。
**Timeout:RecoveryApplyDelay**
由於延遲設定，程序正在等待在復原期間套用預寫日誌 (WAL)。
**Timeout:RecoveryRetrieveRetryInterval**
當預寫日誌 (WAL) 資料無法從任何來源 (pg\$1wal、封存或串流) 取得時，程序會在復原期間等待。
**Timeout:VacuumDelay**
程序正在以成本型清理延遲點等待。
如需 PostgreSQL 等待事件的完整清單，請參閱 PostgreSQL 文件中的[統計數字收集器 > 等待事件表](https://www.postgresql.org/docs/current/monitoring-stats.html#WAIT-EVENT-TABLE)。