# aurora\_ccm\_status
클러스터 캐시 관리자의 상태를 표시합니다.
## 구문
```
aurora_ccm_status()
```
## 인수
없음.
## 반환 타입
다음 열이 있는 SETOF 레코드:
+ `buffers_sent_last_minute` - 지난 1분 동안 지정된 리더로 전송된 버퍼 수입니다.
+ `buffers_found_last_minute` - 지난 1분 동안 식별된 자주 액세스된 버퍼 수입니다.
+ `buffers_sent_last_scan` – 버퍼 캐시의 마지막 전체 검색 중에 지정된 리더로 전송된 버퍼 수입니다.
+ `buffers_found_last_scan` – 버퍼 캐시의 마지막 전체 검색 중에 자주 액세스된 버퍼 수입니다. 지정된 리더에 이미 캐시된 버퍼는 전송되지 않습니다.
+ `buffers_sent_current_scan` - 현재 스캔 중에 전송된 버퍼 수입니다.
+ `buffers_found_current_scan` - 현재 스캔에서 식별된 자주 액세스된 버퍼 수입니다.
+ `current_scan_progress` - 현재 스캔 중에 지금까지 방문한 버퍼 수입니다.
## 사용 노트
이 함수를 사용하여 클러스터 캐시 관리(CCM) 기능을 확인하고 모니터링할 수 있습니다. 이 함수는 Aurora PostgreSQL DB 클러스터에서 CCM이 활성화된 경우에만 작동합니다. 이 함수를 사용하려면 Aurora PostgreSQL DB 클러스터의 Write DB 인스턴스에 연결합니다.
클러스터의 Custom DB 클러스터 파라미터 그룹에서 `apg_ccm_enabled`를 1로 설정하여 Aurora PostgreSQL DB 클러스터에 대한 CCM을 켭니다. 자세한 방법은 [클러스터 캐시 관리 구성](AuroraPostgreSQL.cluster-cache-mgmt.md#AuroraPostgreSQL.cluster-cache-mgmt.Configure)을 참조하세요.
클러스터에 Aurora Reader 인스턴스가 다음과 같이 구성된 경우 Aurora PostgreSQL DB 클러스터에서 클러스터 캐시 관리가 활성화됩니다.
+ Aurora Reader 인스턴스는 클러스터의 Writer 인스턴스와 동일한 DB 인스턴스 클래스 유형 및 크기를 사용합니다.
+ Aurora Reader 인스턴스는 클러스터의 Tier-0으로 구성됩니다. 클러스터에 둘 이상의 Reader가 있는 경우 이게 유일한 Tier-0 Reader입니다.
둘 이상의 Reader를 Tier-0으로 설정하면 CCM이 사용 중지됩니다. CCM이 사용 중지된 경우 이 함수를 호출하면 다음과 같은 오류 메시지가 반환됩니다.
```
ERROR: Cluster Cache Manager is disabled
```
또한 PostgreSQL pg\_buffercache 확장 프로그램을 사용하여 버퍼 캐시를 분석할 수 있습니다. 자세한 내용은 PostgreSQL 설명서의 [pg\_buffercache](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
```