Esquema:

ACCOUNT_USAGE

Exibição REPLICATION_GROUP_REFRESH_HISTORY

Essa exibição do Account Usage pode ser usada para consultar o histórico de atualização de um grupode replicação ou failover específico.

Consulte também:

REPLICATION_GROUP_REFRESH_HISTORY (Função de tabela do Information Schema)

Colunas

Nome da coluna

Tipo de dados

Descrição

REPLICATION_GROUP_NAME

TEXT

Nome do grupo de replicação ou failover secundário.

REPLICATION_GROUP_ID

NUMBER

Identificador interno/gerado pelo sistema para o grupo de replicação ou failover.

PHASE_NAME

TEXT

Fase atual da operação de replicação. Para obter a lista de fases, consulte as Notas de uso.

START_TIME

TIMESTAMP_LTZ

Hora em que a operação de replicação começou.

END_TIME

TIMESTAMP_LTZ

Hora em que a operação de replicação terminou, se aplicável. NULL se ela estiver em progresso.

JOB_UUID

TEXT

ID de consulta para o trabalho de atualização.

TOTAL_BYTES

VARIANT

Um objeto JSON que fornece informações detalhadas sobre bases de dados atualizadas:

  • totalBytesToReplicate: Número total de bytes que se espera que sejam replicados.

  • bytesUploaded: Número real de bytes carregados.

  • bytesDownloaded: Número real de bytes baixados.

  • databases: Lista de objetos JSON contendo os seguintes campos para cada banco de dados membro:

    • name: Nome do banco de dados.

    • totalBytesToReplicate: Total de bytes que se espera que sejam replicados para o banco de dados.

OBJECT_COUNT

VARIANT

Um objeto JSON que fornece informações detalhadas sobre objetos atualizados:

  • totalObjects: Número total de objetos no grupo de replicação ou failover.

  • completedObjects: Número total de objetos concluídos.

  • objectTypes: Lista de objetos JSON contendo os seguintes campos para cada tipo:

    • objectType: Tipo de objeto (por exemplo, usuários, funções, concessões, warehouses, esquemas, tabelas, colunas, etc.).

    • totalObjects: Número total de objetos desse tipo no grupo de replicação ou failover.

    • completedObjects: Número total de objetos desse tipo que foram completados.

PRIMARY_SNAPSHOT_TIMESTAMP

TIMESTAMP_LTZ

Carimbo de data/hora quando a imagem principal foi criada.

ERROR

VARIANT

NULL se a operação de atualização for bem-sucedida. Se a operação de atualização falhar, retorna um objeto JSON que fornece informações detalhadas sobre o erro:

  • errorCode: Código de erro da falha.

  • errorMessage: Mensagem de erro da falha.

Notas de uso

  • A latência da exibição pode ser de até 180 minutos (três horas).

    Para exibir o progresso da atualização em tempo real, use a função de tabela REPLICATION_GROUP_REFRESH_HISTORY.

  • Os resultados são retornados somente para grupos secundários de failover ou replicação na conta atual (a conta de destino).

  • A seguir está a lista de fases na ordem processada:

    #

    Nome da fase

    Descrição

    1

    SECONDARY_SYNCHRONIZING_MEMBERSHIP

    O grupo de failover de replicação ou failover secundário recebe informações do grupo primário sobre os objetos inclusos no grupo e atualiza seus metadados de associação.

    2

    SECONDARY_UPLOADING_INVENTORY

    O grupo de failover de replicação ou failover secundário envia um inventário de seus objetos na conta de destino para o grupo primário.

    3

    PRIMARY_UPLOADING_METADATA

    O grupo de failover ou replicação primário cria uma captura de metadados na conta de origem e a envia ao grupo secundário.

    4

    PRIMARY_UPLOADING_DATA

    O grupo primário de replicação ou grupo de failover copia os arquivos que o grupo secundário precisa para reconciliar quaisquer deltas entre os objetos nas contas de origem e de destino.

    5

    SECONDARY_DOWNLOADING_METADATA

    O grupo de failover ou replicação secundário aplica o instantâneo dos metadados que foram enviados pelo primário. As atualizações de metadados não são aplicadas atomicamente, mas sim ao longo do tempo.

    6

    SECONDARY_DOWNLOADING_DATA

    O grupo de failover ou replicação secundário copia os arquivos enviados pelo grupo primário para a conta de destino.

    7

    COMPLETED / FAILED / CANCELED

    Atualiza o status da operação.

Exemplos

Para recuperar o histórico de atualização do grupo de failover secundário myfg, execute a seguinte instrução:

SELECT phase_name, start_time, end_time,
       total_bytes, object_count, error
  FROM SNOWFLAKE.ACCOUNT_USAGE.REPLICATION_GROUP_REFRESH_HISTORY
  WHERE replication_group_name = 'MYFG';
Copy

Para recuperar o último registro de atualização para cada grupo de failover de replicação ou failover, execute a seguinte instrução:

SELECT replication_group_name, phase_name,
       start_time, end_time,
       total_bytes, object_count, error,
       ROW_NUMBER() OVER (
         PARTITION BY replication_group_name
         ORDER BY end_time DESC
       ) AS row_num
  FROM SNOWFLAKE.ACCOUNT_USAGE.REPLICATION_GROUP_REFRESH_HISTORY
  QUALIFY row_num = 1;
Copy