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 インスタンスに接続します。

Aurora PostgreSQL DB クラスターの CCM をオンにするには、apg_ccm_enabled をクラスターのカスタム DB クラスターパラメータグループで 1 に設定します。この方法については、「クラスターキャッシュ管理の設定」を参照してください。

Aurora PostgreSQL DB クラスターでクラスターキャッシュ管理が有効になるのは、クラスターに Aurora Reader インスタンスが以下のように構成されている場合です。

  • Aurora Reader インスタンスは、クラスターの Writer インスタンスと同じ DB インスタンスクラスタイプとサイズを使用します。

  • Aurora Reader インスタンスは、クラスターの Tier-0 として構成されています。クラスターに複数の Reader がある場合、これは唯一の Tier-0 リーダーです。

複数のリーダーを Tier-0 に設定すると、CCM が無効になります。CCM が無効の場合、この関数を呼び出すと、次のエラーメッセージが返されます。

ERROR: Cluster Cache Manager is disabled

PostgreSQL pg_buffercache 拡張を使用して、バッファキャッシュを分析することもできます。詳細については、PostgreSQL ドキュメントの「pg_buffercache」を参照してください。

詳細については、「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