aurora_global_db_instance_status
Aurora グローバル DB クラスター内のレプリカを含む、すべての Aurora インスタンスのステータスを表示します。
構文
aurora_global_db_instance_status()引数
なし
戻り型
次の列を含む SETOF レコード。
server_id– DB インスタンスの ID。session_id– セッションの一意の識別子。MASTER_SESSION_IDの値は、Writer (プライマリ) DB インスタンスを識別します。aws_region– このグローバル DB インスタンスが実行される AWS リージョン。リージョンのリストについては、「利用可能なリージョン」を参照してください。durable_lsn– ストレージで耐久性のあるログシーケンス番号 (LSN)。ログシーケンス番号 (LSN) は、データベーストランザクションログ内のレコードを識別する一意の連続番号です。LSN は、より大きな LSN が後のトランザクションを表すように順序付けられます。highest_lsn_rcvd— Writer DB インスタンスから DB インスタンスが受信した最も高い LSN。feedback_epoch- DB インスタンスがホットスタンバイ情報を生成するときに使用するエポック。ホットスタンバイとは、プライマリ DB が復旧モードまたはスタンバイモードのときに、接続とクエリをサポートする DB インスタンスのことです。ホットスタンバイ情報には、ホットスタンバイとして使用されている DB インスタンスに関するエポック (時点) やその他の詳細が含まれます。詳細については、PostgreSQL ドキュメントの「ホットスタンバイ」を参照してください。 feedback_xmin– DB インスタンスで使用される最小の (最も古い) アクティブトランザクション ID。oldest_read_view_lsn- ストレージから読み取るために DB インスタンスが使用した最も古い LSN。visibility_lag_in_msec– この DB インスタンスが Writer DB インスタンスからどれだけ遅れているか (ミリ秒単位)。
使用に関する注意事項
この関数は、Aurora DB クラスターのレプリケーションの統計を表示します。この関数は、クラスター内の各 Aurora PostgreSQL DB インスタンスについて、グローバルデータベース設定に任意のクロスリージョンレプリカを含むデータの行を表示します。
この関数は、Aurora PostgreSQL DB クラスターまたは Aurora PostgreSQL グローバルデータベースのどのインスタンスからでも実行できます。この関数は、すべてのレプリカインスタンスの遅延に関する詳細を返します。
この関数 (aurora_global_db_instance_status) または aurora_global_db_status を使用した遅延のモニタリングの詳細については、「Aurora PostgreSQL ベースのグローバルデータベースのモニタリング」を参照してください。
Aurora グローバルデータベースの詳細については、「Amazon Aurora Global Database の概要」を参照してください。
Aurora グローバルデータベースの開始方法については、「Amazon Aurora Global Database の開始方法」または「Amazon Aurora よくある質問
例
この例は、クロスリージョンインスタンスの統計を示しています。
=>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
