本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 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
```