Categorias:

Information Schema , Funções de tabela

DATABASE_REFRESH_PROGRESS , DATABASE_REFRESH_PROGRESS_BY_JOB

A família de funções DATABASE_REFRESH_PROGRESS pode ser usada para consultar o status de uma atualização do banco de dados em várias dimensões:

  • DATABASE_REFRESH_PROGRESS retorna um objeto JSON indicando o status atual de atualização de um banco de dados secundário pelo nome.

  • DATABASE_REFRESH_PROGRESS_BY_JOB retorna um objeto JSON indicando o status atual de atualização de um banco de dados secundário através de uma consulta de atualização.

Cada função é otimizada para consulta na dimensão especificada.

Nota

  • DATABASE_REFRESH_PROGRESS só retorna a atividade de atualização do banco de dados para a atualização mais recente se ela ocorreu nos últimos 14 dias.

  • DATABASE_REFRESH_PROGRESS_BY_JOB devolve atividade de atualização do banco de dados nos últimos 14 dias.

Consulte também:

DATABASE_REFRESH_HISTORY

Sintaxe

DATABASE_REFRESH_PROGRESS( '<secondary_db_name>' )

DATABASE_REFRESH_PROGRESS_BY_JOB( '<query_id>' )
Copy

Argumentos

secondary_db_name

Nome do banco de dados secundário. Este argumento é opcional se o banco de dados secundário for o banco de dados ativo na sessão atual.

Observe que o nome completo deve ser delimitado por aspas simples.

query_id

ID da consulta de atualização do banco de dados. A ID da consulta pode ser obtida da página History Guia Histórico na interface da Web.

Notas de uso

  • Só retorna resultados para administradores de conta (usuários com a função ACCOUNTADMIN).

  • Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

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

    1. SECONDARY_UPLOADING_INVENTORY

    2. PRIMARY_UPLOADING_METADATA

    3. PRIMARY_UPLOADING_DATA

    4. SECONDARY_DOWNLOADING_METADATA

    5. SECONDARY_DOWNLOADING_DATA

    6. COMPLETED / FAILED / CANCELED

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

PHASE_NAME

TEXT

Nome das fases de replicação concluídas (ou em andamento) até o momento. Para a lista de fases, consulte as notas de uso.

RESULT

TEXT

Status da fase de replicação. Os status válidos são EXECUTING, SUCCEEDED, CANCELLED, FAILED.

START_TIME

NUMBER

Hora em que a fase de replicação começou. O formato é hora de época.

END_TIME

NUMBER

Hora em que a fase terminou, se aplicável. O formato é hora de época.

DETAILS

VARIANT

Retornado apenas pela função DATABASE_REFRESH_PROGRESS. Um objeto JSON que fornecia informações detalhadas para as seguintes fases: . - Dados de carregamento primário: o carimbo de data/hora do instantâneo atual do banco de dados primário. . - Dados de carregamento primário e Dados de descarregamento secundário: número total de bytes na atualização do banco de dados, assim como o número de bytes copiados até o momento na fase. . - Metadados de descarregamento secundário: o número de tabelas, colunas de tabelas e todos os objetos de banco de dados (incluindo tabelas e colunas de tabelas) no último instantâneo do banco de dados primário.

Exemplos

Recuperar o progresso atual da atualização do banco de dados para o banco de dados mydb1:

select *
from table(information_schema.database_refresh_progress(mydb1));
Copy

Recuperar o progresso atual de uma atualização do banco de dados pela ID da consulta:

select *
from table(information_schema.database_refresh_progress_by_job('012a3b45-1234-a12b-0000-1aa200012345'));
Copy