Categorias:

Information Schema , Funções de tabela

LISTING_REFRESH_HISTORY

Retorna os últimos 14 dias do histórico de atualização de uma listagem de preenchimento automático entre nuvens. As informações retornadas contêm detalhes de replicação para eventos de atualização em que a listagem é sincronizada com uma região de destino especificada.

Essa função está disponível para provedores de listagens que tenham qualquer privilégio na listagem especificada.

Sintaxe

LISTING_REFRESH_HISTORY(
  LISTING_NAME => '<listing_name>'
  [ , SNOWFLAKE_REGION => '<snowflake_region>' ]
  [ , REGION_GROUP => '<region_group>' ] )
Copy

Argumentos

Obrigatório

LISTING_NAME => 'listing_name'

O identificador SQL de uma listagem de preenchimento automático entre nuvens nessa conta. O identificador SQL para listagens pode ser encontrado na coluna name retornada pelo comando show listings in data exchange <exchange_name>. Da mesma forma, o identificador SQL para trocas de dados pode ser encontrado na coluna name retornada por show data exchanges.

Opcional

SNOWFLAKE_REGION => 'snowflake_region'

O grupo de regiões do Snowflake para o qual a listagem é replicada, onde é possível visualizar o histórico de atualização dessa replicação. Isso segue a mesma formatação da coluna snowflake_region retornada por SHOW REGIONS. Se nenhuma região for especificada, o histórico de todas as regiões de destino será exibido.

REGION_GROUP =>  'region_group'

O grupo de regiões do Snowflake para o qual a listagem é replicada, para o qual é possível visualizar o histórico de atualização.

PUBLIC por padrão. Esse argumento só precisa ser especificado se a região de destino que está sendo monitorada estiver em uma região do governo dos US ou uma Virtual Private Snowflake.

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

LISTING_NAME

TEXT

Nome da listagem de preenchimento automático entre nuvens nesta conta.

SNOWFLAKE_REGION

TEXT

Nome da região do Snowflake para a qual a listagem é replicada. Por exemplo, aws_us_east_1.

REGION_GROUP

TEXT

Nome do grupo de região do Snowflake para o qual a listagem é replicada. Por exemplo, PUBLIC.

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

O progresso atual de replicação como uma porcentagem.

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.

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

  • Retorna apenas as linhas de uma função com qualquer privilégio na listagem.

  • Retorna apenas as linhas de uma listagem na conta atual.

  • 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

  • A saída também incluirá o histórico de outras listagens que fazem referência ao mesmo banco de dados, pois elas são atualizadas em conjunto. Se a entrada for uma listagem de aplicativos, ela conterá o histórico de todas as listagens de aplicativos na região determinada.

  • Nas fases PRIMARY_UPLOADING_DATA e SECONDARY_DOWNLOADING_DATA, o valor totalBytesToReplicate é estimado antes da operação de replicação. Esse valor pode ser diferente do valor totalBytesToUpload ou totalBytesToDownload na respectiva fase.

    Por exemplo, se durante a fase PRIMARY_UPLOADING_DATA, uma operação de replicação anterior carregasse alguns bytes mas fosse cancelada antes que a operação fosse concluída, esses bytes não seriam carregados novamente. Nesse caso, totalBytesToUpload seria inferior a totalBytesToReplicate.

Exemplos

Recupere o histórico da listagem my_listing atualizando para AWS US East-1, uma região de nuvem pública.

select * from table(information_schema.listing_refresh_history(listing_name=>'my_listing',snowflake_region=>'AWS_US_EAST_1))
Copy
Linguagem: Português