aurora_global_db_instance_status - Amazon Aurora
SintaxeArgumentosTipo de retornoObservações de usoExemplos

aurora_global_db_instance_status

Exibe o status de todas as instâncias do Aurora, incluindo as réplicas em um cluster de banco de dados global do Aurora.

Sintaxe

aurora_global_db_instance_status()

Argumentos

Nenhum

Tipo de retorno

Registro SETOF com as seguintes colunas:

  • server_id: o identificador da instância de banco de dados.

  • session_id: o identificador exclusivo da sessão. O valor de MASTER_SESSION_ID identifica a instância de banco de dados do leitor (primário).

  • aws_region: a Região da AWS em que essa instância de banco de dados global é executada. Para obter uma lista de regiões, consulte Disponibilidade de regiões.

  • durable_lsn: o número de sequência de log (LSN) que se tornou durável no armazenamento. Um número de sequência de log (LSN) é um número sequencial exclusivo que identifica um registo no log de transações do banco de dados. LSNs são ordenados de forma que um LSN maior represente uma transação posterior.

  • highest_lsn_rcvd: o LSN mais alto recebido pela instância de banco de dados do gravador.

  • feedback_epoch: a época que a instância de banco de dados usa ao gerar informações de standby a quente. Standby a quente é uma instância de banco de dados que oferece suporte às conexões e às consultas quando o banco de dados primário está no modo de recuperação ou de standby. As informações de standby a quente incluem a época (ponto no tempo) e outros detalhes sobre a instância de banco de dados que está sendo usada como standby a quente. Para obter mais informações, consulte Hot Standby na documentação do PostgreSQL.

  • feedback_xmin: o ID mínimo (mais antigo) da transação ativa usado pela instância de banco de dados.

  • oldest_read_view_lsn: o LSN mais antigo usado pela instância de banco de dados para fazer a leitura no armazenamento.

  • visibility_lag_in_msec: o tempo de atraso dessa instância de banco de dados em relação à instância de banco de dados do gravador, em milissegundos.

Observações de uso

Essa função mostra estatísticas de replicação de um cluster de banco de dados do Aurora. Para cada instância de banco de dados do Aurora PostgreSQL no cluster, a função mostra uma linha de dados que inclui todas as réplicas entre regiões em uma configuração de banco de dados global.

É possível executar essa função em qualquer instância em um cluster de banco de dados do Aurora PostgreSQL ou em um banco de dados global do Aurora PostgreSQL. A função retorna detalhes sobre o atraso de todas as instâncias de réplica.

Para saber mais sobre o monitoramento de atraso usando essa função (aurora_global_db_instance_status) ou usando aurora_global_db_status, consulte Monitorar banco de dados globais baseados no Aurora PostgreSQL.

Para obter mais informações sobre bancos de dados globais do Aurora, consulte Visão geral de bancos de dados globais do Amazon Aurora.

Para obter os conceitos básicos sobre bancos de dados globais do Aurora, consulte Conceitos básicos de bancos de dados globais do Amazon Aurora ou Perguntas frequentes sobre o Amazon Aurora.

Exemplos

Este exemplo mostra as estatísticas de instâncias entre regiões.

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

Este exemplo mostra como verificar o atraso de uma réplica global em milissegundos. 

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

Este exemplo mostra como verificar o atraso mínimo, máximo e médio por Região da AWS na configuração do banco de dados 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