aurora_global_db_instance_status

Zeigt den Status aller Aurora-Instances an, einschließlich Replikaten in einem globalen Aurora-DB-Cluster.

Syntax

aurora_global_db_instance_status()

Argumente

Keine

Rückgabetyp

SETOF-Datensatz mit den folgenden Spalten:

• server_id – Die ID der DB-Instance.

• session_id – Eindeutiger Bezeichner für die aktuelle Sitzung. Der Wert MASTER_SESSION_ID bezeichnet die (primäre) Writer-DB-Instance.

• aws_region – Die AWS-Region, in der diese globale DB-Instance ausgeführt wird. Eine Liste der Regionen finden Sie unter Verfügbarkeit in Regionen.

• durable_lsn – Die Log-Sequenznummer (LSN), die dauerhaft gespeichert wurde. Eine Log-Sequenznummer (LSN) ist eine eindeutige fortlaufende Nummer, die einen Datensatz im Datenbank-Transaktionsprotokoll identifiziert. LSNs werden so angeordnet, dass eine größere LSN eine spätere Transaktion darstellt.

• highest_lsn_rcvd – Die höchste LSN, die die DB-Instance von der Writer-DB-Instance empfangen hat.

• feedback_epoch – Die Epoche, die die DB-Instance beim Erzeugen der Hot-Standby-Informationen verwendet. Ein Hot Standby ist eine DB-Instance, die Verbindungen und Abfragen unterstützt, während sich die primäre DB im Wiederherstellungs- oder Standby-Modus befindet. Die Hot-Standby-Informationen umfassen die Epoche (bestimmter Zeitpunkt) und andere Details über die DB-Instance, die als Hot-Standby verwendet wird. Weitere Informationen finden Sie in der PostgreSQL-Dokumentation zu Hot Standby.

• feedback_xmin – Die minimale (älteste) aktive Transaktions-ID, die von der DB-Instance verwendet wird.

• oldest_read_view_lsn – Die älteste LSN, die von der DB-Instance zum Lesen aus dem Speicher verwendet wird.

• visibility_lag_in_msec – Gibt an (in Millisekunden), wie weit die DB-Instance hinter der Writer-DB-Instance zurückgeblieben ist.

Nutzungshinweise

Diese Funktion gibt Aufschluss über Replikationsstatistiken für einen Aurora-DB-Cluster. Für jede Aurora-PostgreSQL-DB-Instance im Cluster zeigt die Funktion eine Datenreihe an, die regionsübergreifende Replikate in einer globalen Datenbankkonfiguration enthält.

Sie können diese Funktion von jeder Instance in einem Aurora-PostgreSQL-DB-Cluster oder einer globalen Aurora-PostgreSQL-Datenbank ausführen. Die Funktion gibt Details zur Verzögerung für alle Replikat-Instances zurück.

Weitere Informationen über die Überwachung der Verzögerung mithilfe dieser Funktion (aurora_global_db_instance_status) oder mit aurora_global_db_status finden Sie unter Überwachen von Aurora-PostgreSQL-basierten globalen Datenbanken.

Informationen über globale Aurora-Datenbanken finden Sie unter Übersicht über Amazon Aurora Global Databases.

Informationen zu den ersten Schritten mit globalen Aurora-Datenbanken finden Sie unter Erste Schritte mit globalen Amazon-Aurora-Datenbanken oder Häufig gestellte Fragen zu Amazon Aurora.

Beispiele

Dieses Beispiel zeigt regionsübergreifende Instance-Statistiken.

=> 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

Dieses Beispiel veranschaulicht, wie die globale Replikatverzögerung in Millisekunden überprüft wird.

=> 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

Dieses Beispiel zeigt, wie die minimale, maximale und durchschnittliche Verzögerung je AWS-Region im Hinblick auf die globale Datenbankkonfiguration überprüft wird.

=> 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