aurora_global_db_instance_status - Amazon Aurora
SintaxisArgumentosTipo de retornoNotas de usoEjemplos

aurora_global_db_instance_status

Muestra el estado de todas las instancias de Aurora, incluidas las réplicas de un clúster de base de datos global de Aurora.

Sintaxis

aurora_global_db_instance_status()

Argumentos

Ninguno

Tipo de retorno

Registro SETOF con las siguientes columnas:

  • server_id: el identificador de la instancia de base de datos.

  • session_id: un identificador único de la sesión actual. Un valor MASTER_SESSION_ID identifica la instancia de base de datos de Writer (principal).

  • aws_region: la Región de AWS en la que se ejecuta esta instancia de base de datos global. Para obtener una lista de regiones, consulte Disponibilidad por región.

  • durable_lsn: el número de secuencia de registro (LSN) hecho duradero en el almacenamiento. Un número de secuencia de registro (LSN) es un número secuencial único que identifica un registro en el registro de transacciones de la base de datos. Los LSN se ordenan de tal manera que un LSN más grande representa una transacción posterior.

  • highest_lsn_rcvd: LSN más alto recibido por la instancia de base de datos de la instancia de base de datos de escritor.

  • feedback_epoch: fecha de inicio que utiliza la instancia de base de datos cuando genera información en espera activa. Una espera activa es una instancia de base de datos que admite conexiones y consultas mientras la base de datos principal está en modo de recuperación o espera. La información de espera activa incluye la época (punto en el tiempo) y otros detalles sobre la instancia de base de datos que se utiliza como reserva activa. Para obtener más información, consulte la documentación de PostgreSQL sobre Espera activa.

  • feedback_xmin: ID de transacción activo mínimo (más antiguo) utilizado por la instancia de base de datos.

  • oldest_read_view_lsn: LSN más antiguo utilizado por la instancia de base de datos para leer desde el almacenamiento.

  • visibility_lag_in_msec: tiempo que esta instancia de base de datos se está quedando por detrás de la instancia de base de datos de escritor en milisegundos.

Notas de uso

Esta función muestra estadísticas de replicación para un clúster de base de datos Aurora. Para cada instancia de base de datos Aurora PostgreSQL del clúster, la función muestra una fila de datos que incluye cualquier réplica entre regiones en una configuración de base de datos global.

Puede ejecutar esta función desde cualquier instancia de un clúster de base de datos Aurora PostgreSQL o una base de datos global de Aurora PostgreSQL. La función devuelve detalles sobre el retraso de todas las instancias de réplica.

Para obtener más información sobre el retraso de la supervisión mediante esta función (aurora_global_db_instance_status) o utilizando aurora_global_db_status, consulteSupervisión de bases de datos globales basadas en Aurora PostgreSQL.

Para obtener información sobre las bases de datos globales de Aurora, consulte Información general sobre las bases de datos globales de Amazon Aurora.

Para empezar a utilizar bases de datos globales de Aurora, consulte Introducción a bases de datos globales de Amazon Aurora o consulte Preguntas frecuentes de Amazon Aurora.

Ejemplos

En este ejemplo se muestran estadísticas de instancias entre regiones.

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

En este ejemplo se muestra cómo comprobar el retraso de réplica global en milisegundos. 

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

En este ejemplo se muestra cómo comprobar el retraso mínimo, máximo y medio por Región de AWS desde la configuración de base de datos global.

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