aurora_ccm_status - Amazon Aurora
조건인수반환 유형사용 노트예시

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을 켭니다. 자세한 방법은 클러스터 캐시 관리 구성 섹션을 참조하세요.

클러스터에 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를 참조하세요.

자세한 내용은 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