aurora_global_db_instance_status

Affiche l'état de toutes les instances Aurora, y compris les réplicas dans un cluster de bases de données global Aurora.

Syntaxe

aurora_global_db_instance_status()

Arguments

Aucune

Type de retour

Registre SETOF avec les colonnes suivantes :

• server_id – Identifiant de l'instance de base de données.

• session_id – Identifiant unique de la session en cours. La valeur MASTER_SESSION_ID identifie l'instance de base de données d'enregistreur (principale).

• aws_region – La Région AWS dans laquelle cette instance de base de données globale s'exécute. Pour obtenir la liste des régions, consultez Disponibilité dans les Régions.

• durable_lsn – Numéro de séquence de journal (LSN) rendu durable dans le stockage. Un numéro de séquence de journal (LSN) est un numéro séquentiel unique qui identifie un enregistrement dans le journal des transactions de la base de données. Les LSN sont classés de telle sorte qu'un LSN plus grand représente une transaction ultérieure.

• highest_lsn_rcvd – LSN le plus élevé reçu par l'instance de base de données en provenance de l'instance de base de données d'enregistreur.

• feedback_epoch – Époque utilisée par l'instance de base de données lorsqu'elle génère des informations de zone hébergée. Le terme zone hébergée fait référence à une instance de base de données qui prend en charge les connexions et les requêtes pendant que la base de données principale est en mode de récupération ou en mode veille. Les informations de zone hébergée incluent l'époque (instant dans le passé) et d'autres détails sur l'instance de base de données utilisée comme une zone hébergée. Pour de plus amples informations, veuillez consulter la documentation PostgreSQL sur Veille à chaud.

• feedback_xmin – ID de transaction actif minimal (le plus ancien) utilisé par l'instance de base de données.

• oldest_read_view_lsn : le LSN le plus ancien utilisé par l'instance de base de données pour lire à partir du stockage.

• visibility_lag_in_msec – Latence de cette instance de base de données par rapport à l'instance de base de données d'enregistreur en millisecondes.

Notes d'utilisation

Cette fonction affiche les statistiques de réplication pour un cluster de bases de données Aurora. Pour chaque instance de base de données Aurora PostgreSQL du cluster, la fonction affiche une ligne de données qui inclut tous les réplicas entre régions dans une configuration de base de données globale.

Vous pouvez exécuter cette fonction à partir de n'importe quelle instance d'un cluster de bases de données Aurora PostgreSQL ou d'une base de données globale Aurora PostgreSQL. La fonction renvoie des détails sur la latence décalage pour toutes les instances de réplica.

Pour en savoir plus sur la surveillance de la latence à l'aide de cette fonction (aurora_global_db_instance_status) ou de aurora_global_db_status, consultez Surveillance des bases de données globales basées sur Aurora PostgreSQL.

Pour plus d'informations sur les bases de données globales Aurora, consultez Présentation des bases de données globales Amazon Aurora.

Pour commencer à utiliser les bases de données globales Aurora, consultez Mise en route avec les bases de données Amazon Aurora globales ou la FAQ Amazon Aurora.

Exemples

Cet exemple montre les statistiques des instances entre régions.

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

Cet exemple montre comment vérifier la latence de réplica globale en millisecondes.

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

Cet exemple montre comment vérifier la latence minimale, maximale et moyenne par Région AWS à partir de la configuration de base de données globale.

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