SHOW SNAPSHOTS IN SNAPSHOT SET

Lista todos os instantâneos em um conjunto de instantâneos.

Consulte também:

CREATE SNAPSHOT SET, ALTER SNAPSHOT SET, SHOW SNAPSHOT SETS

Sintaxe

SHOW SNAPSHOTS IN SNAPSHOT SET <name>
Copy

Parâmetros

name

Especifica o identificador do conjunto de instantâneos.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Notas

OWNERSHIP

Você deve ter o privilégio OWNERSHIP no conjunto de instantâneos para ver os instantâneos que ele contém.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • O comando retorna um máximo de dez mil registros para o tipo de objeto especificado, conforme ditado pelos privilégios de acesso da função usada para executar o comando. Todos os registros acima do limite de dez mil registros não são retornados, mesmo com um filtro aplicado.

    Para visualizar os resultados para os quais existem mais de dez mil registros, consulte a exibição correspondente (se houver) em Snowflake Information Schema.

Saída

Coluna

Descrição

created_on

O instantâneo de carimbo de data/hora é criado.

snapshot_id

Identificador do instantâneo gerado pelo Snowflake. O ID do instantâneo é um valor UUID, no formato retornado pela função UUID_STRING.

snapshot_set_name

Nome do conjunto de instantâneos que contém o instantâneo.

database_name

Nome do banco de dados que contém o conjunto de instantâneos.

schema_name

Nome do esquema que contém o conjunto de instantâneos.

expire_on

Carimbo de data/hora quando o instantâneo expira.

Exemplos

Listar todos os instantâneos no conjunto de instantâneos t1_snapshots:

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots;
Copy

Mostrar a data de criação e o ID de instantâneo do instantâneo mais antigo no conjunto de instantâneos t1_snapshots:

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->>
  SELECT "created_on", "snapshot_id" FROM $1
    ORDER BY "created_on" LIMIT 1;
Copy

Mostrar o ID do instantâneo e a data e hora em que o instantâneo final no conjunto de instantâneos t1_snapshots expirará. Este exemplo presume que a política de instantâneos não inclui um cronograma, ou a política de instantâneos está suspensa para o conjunto de instantâneos, de modo que nenhum novo instantâneo está sendo adicionado ao conjunto de instantâneos. Você está apenas esperando que todos os instantâneos existentes expirem para que você possa descartar o conjunto de instantâneos.

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->>
  SELECT "expire_on", "snapshot_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;
Copy
Linguagem: Português