SHOW BACKUPS IN BACKUP SET

Lista todos os backups em um conjunto de backups.

Consulte também:

CREATE BACKUP SET, ALTER BACKUP SET, SHOW BACKUP SETS

Sintaxe

SHOW BACKUPS IN BACKUP SET <name>
  [ LIMIT <rows> ]
Copy

Parâmetros

name

Especifica o identificador do conjunto de backups.

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.

LIMIT rows

Opcionalmente, limita o número máximo de linhas retornadas, ao mesmo tempo em que permite a «paginação» dos resultados. O número real de linhas retornadas pode ser menor que o limite especificado. Por exemplo, o número de objetos existentes é menor que o limite especificado.

Padrão: nenhum valor (nenhum limite é aplicado à saída)

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 backups para ver os backups 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

Um backup do carimbo de data/hora é criado.

backup_id

Identificador do backup gerado pelo Snowflake. O ID do backup é um valor de UUID no formato retornado pela função UUID_STRING.

backup_set_name

Nome do conjunto de backups que contém o backup.

database_name

Nome do banco de dados que contém o conjunto de backups.

schema_name

Nome do esquema que contém o conjunto de backups.

expire_on

Carimbo de data/hora de quando o backup expira.

Exemplos

Liste todos os backups no conjunto de backups t1_backups:

SHOW BACKUPS IN BACKUP SET t1_backups;
Copy

Mostre a data de criação e o ID do backup mais antigo no conjunto de backups t1_backups:

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "created_on", "backup_id" FROM $1
    ORDER BY "created_on" LIMIT 1;
Copy

Mostre o ID do backup e a data e hora em que o último backup no conjunto de backups t1_backups vai expirar. Este exemplo pressupõe que a política de backup não inclui um agendamento ou que a política de backup está suspensa para o conjunto de backups, de modo que nenhum novo backup seja adicionado ao conjunto. Você está apenas aguardando que todos os backups existentes expirem para poder descartar o conjunto de backups.

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "expire_on", "backup_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;
Copy
Linguagem: Português