aurora_global_db_status - Amazon Aurora
構文引数戻り型使用に関する注意事項例

aurora_global_db_status

Aurora グローバルデータベースの遅延のさまざまな側面に関する情報を表示します。具体的には、基盤となる Aurora ストレージの遅延 (いわゆる耐久性の遅延) と目標復旧時点 (RPO) 間の遅延などです。

構文

aurora_global_db_status()

引数

なし。

戻り型

次の列を含む SETOF レコード。

  • aws_region – この DB クラスターがある AWS リージョン。エンジン別の AWS リージョン の一覧については、「リージョンとアベイラビリティーゾーン」を参照してください。

  • highest_lsn_written – この DB クラスターに現在存在するログシーケンス番号 (LSN) の最大値。ログシーケンス番号 (LSN) は、データベーストランザクションログ内のレコードを識別する一意の連続番号です。LSN は、より大きな LSN が後のトランザクションを表すように順序付けられます。

  • durability_lag_in_msec – セカンダリ DB クラスターの highest_lsn_written とプライマリ DB クラスターの highest_lsn_written とのタイムスタンプ値の差。-1 の値は、Aurora グローバルデータベースのプライマリ DB クラスターを識別します。

  • rpo_lag_in_msec – 目標復旧時点 (RPO)の遅延。RPO 遅延とは、最近のユーザートランザクション COMMIT が、Aurora グローバルデータベースのプライマリ DB クラスターに保存された後、セカンダリ DB クラスターに保存されるまでにかかる時間です。-1 の値は、プライマリ DB クラスターを表します (したがって、遅延は関係ありません)。

    簡単に言えば、このメトリクスは、Aurora グローバルデータベース内の各 Aurora PostgreSQL DB クラスターの目標復旧時点、つまり、障害が発生した場合に失われる可能性のあるデータの量を計算します。遅延と同様に、RPO は時間単位で測定されます。

  • last_lag_calculation_time – durability_lag_in_msec と rpo_lag_in_msec に対して値が最後に計算された時刻を指定するタイムスタンプ。1970-01-01 00:00:00+00 のような時間値は、これがプライマリ DB クラスターであることを意味します。

  • feedback_epoch – セカンダリ DB クラスターがホットスタンバイ情報を生成するときに使用するエポック。ホットスタンバイとは、プライマリ DB が復旧モードまたはスタンバイモードのときに、接続とクエリをサポートする DB インスタンスのことです。ホットスタンバイ情報には、ホットスタンバイとして使用されている DB インスタンスに関するエポック (時点) やその他の詳細が含まれます。詳細については、PostgreSQL ドキュメントの「ホットスタンバイ」を参照してください。

  • feedback_xmin – セカンダリ DB クラスターで使用される最小 (最も古い) のアクティブトランザクション ID。

使用に関する注意事項

この関数は、Aurora グローバルデータベースのレプリケーションの統計を表示します。Aurora PostgreSQL グローバルデータベース内の各 DB クラスターに対して 1 つの行が表示されます。この関数は、Aurora PostgreSQL グローバルデータベースのどのインスタンスからでも実行できます。

目に見えるデータ遅延である Aurora グローバルデータベースレプリケーションの遅延を評価するには、「aurora_global_db_instance_status」を参照してください。

aurora_global_db_status や aurora_global_db_instance_status を使用して Aurora グローバルデータベースラグをモニタリングする方法の詳細については、「Aurora PostgreSQL ベースのグローバルデータベースのモニタリング」を参照してください。Aurora グローバルデータベースの詳細については、「Amazon Aurora Global Database の概要」を参照してください。

例

この例は、クロスリージョンストレージの統計情報を表示する方法を示します。

=> SELECT CASE 
          WHEN '-1' = durability_lag_in_msec THEN 'Primary'
          ELSE 'Secondary'
       END AS global_role,
       *
  FROM aurora_global_db_status();
 global_role | aws_region | highest_lsn_written | durability_lag_in_msec | rpo_lag_in_msec | last_lag_calculation_time  | feedback_epoch | feedback_xmin
-------------+------------+---------------------+------------------------+-----------------+----------------------------+----------------+---------------
 Primary     | eu-west-1  |           131031557 |                     -1 |              -1 | 1970-01-01 00:00:00+00     |              0 |             0
 Secondary   | eu-west-2  |           131031554 |                    410 |               0 | 2021-06-01 18:59:36.124+00 |              0 |         12640
 Secondary   | eu-west-3  |           131031554 |                    410 |               0 | 2021-06-01 18:59:36.124+00 |              0 |         12640