Categorias:: Information Schema , Funções de tabela

AVAILABLE_LISTING_REFRESH_HISTORY¶

Retorna os últimos 14 dias do histórico de atualização de uma listagem disponível ou de um banco de dados montado a partir de uma listagem usando o preenchimento automático entre nuvens. As informações retornadas contêm detalhes de replicação dos dados adicionados ao banco de dados de listagem em cada evento de atualização. Essa função está disponível para consumidores de listagens que tenham qualquer privilégio na listagem disponível ou no banco de dados montado.

Sintaxe¶

AVAILABLE_LISTING_REFRESH_HISTORY(
  OBJECT_TYPE => '<object_type>',
  OBJECT_NAME => '<object_name>' )

Copy

Argumentos¶

OBJECT_TYPE => 'object_type': Tipo de objeto, listing ou database.
OBJECT_NAME => 'object_name': Nome do objeto, que pode ser o nome global da listagem ou o nome do banco de dados montado, dependendo do tipo de objeto.

Saída¶

A função retorna as seguintes colunas:

Nome da coluna	Tipo de dados	Descrição
OBJECT_TYPE	TEXT	Lista o tipo de objeto Snowflake. Por exemplo, listagem.
OBJECT_NAME	TEXT	Nome da listagem ou do banco de dados montado.
PHASE	TEXT	Fase atual na operação de replicação, representada como uma fase de um total de X fases. Por exemplo, 2/6.
PHASE_NAME	TEXT	Nome das fases de replicação concluídas (ou em andamento) até o momento. Para obter a lista de fases, consulte as notas de uso.
PROGRESS	TEXT	PRIMARY_UPLOADING_DATA: Porcentagem do total de bytes replicados. SECONDARY_DOWNLOADING_METADATA: Porcentagem do número total de objetos replicados. SECONDARY_DOWNLOADING_DATA: Porcentagem do total de bytes replicados. Vazio para as fases restantes
START_TIME	TIMESTAMP_LTZ	Hora em que a fase de replicação começou.
END_TIME	TIMESTAMP_LTZ	Hora em que a fase terminou, se aplicável. NULL se a fase estiver em andamento ou for a fase de encerramento (`COMPLETED/FAILED/CANCELED`).
JOB_UUID	TEXT	ID de consulta para o trabalho de atualização.
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¶

Somente retorna linhas para uma função com qualquer privilégio na listagem, se a listagem estiver visível para a conta.
Quando object_type é definido como database (em oposição a listing), são retornadas somente as linhas das funções com qualquer privilégio nesse banco de dados.
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 informações, consulte Information Schema.

Lista de fases na ordem de processamento:
1. SECONDARY_SYNCHRONIZING_MEMBERSHIP
2. SECONDARY_UPLOADING_INVENTORY
3. PRIMARY_UPLOADING_METADATA
4. PRIMARY_UPLOADING_DATA
5. SECONDARY_DOWNLOADING_METADATA
6. SECONDARY_DOWNLOADING_DATA
7. COMPLETED / FAILED / CANCELED

Exemplos¶

Recupere o histórico do banco de dados my_mounted_database.

SELECT * FROM TABLE(
  INFORMATION_SCHEMA.AVAILABLE_LISTING_REFRESH_HISTORY(
    OBJECT_TYPE=>'database',
    OBJECT_NAME=>'my_mounted_database'
  )
);

Copy