DROP SNAPSHOT

Nota

Esta operação não é atualmente coberta pelo nível de serviço definido na Política de suporte e Acordo de nível de serviço da Snowflake.

Remove um instantâneo de um volume de armazenamento em bloco. Um instantâneo são dados persistentes pelos quais o cliente paga. DROP SNAPSHOT diz ao Snowflake para excluir esses dados. Os dados não estão mais disponíveis para uso como um instantâneo e o cliente não paga mais por eles.

Consulte também:

CREATE SNAPSHOT , ALTER SNAPSHOT, DESCRIBE SNAPSHOT, SHOW SNAPSHOTS

Sintaxe

DROP SNAPSHOT [ IF EXISTS ] <name>;
Copy

Parâmetros

name

Especifica o identificador do instantâneo a ser descartado.

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

Objeto

Notas

OWNERSHIP

Instantâneo

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema. Observe que uma função com privilégio concedido em um esquema permite que essa função resolva o esquema. Por exemplo, uma função com privilégio CREATE concedido em um esquema pode criar objetos nesse esquema sem também ter USAGE concedido nesse esquema.

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

  • Quando a cláusula IF EXISTS é especificada e o objeto de destino não existe, o comando é concluído com sucesso sem retornar um erro.

  • Dropping a snapshot does not immediately remove it from the system. A version of the dropped snapshot is retained in Time Travel for the number of days specified by the DATA_RETENTION_TIME_IN_DAYS parameter for the parent schema, database, or account:

    • Within the Time Travel retention period, a dropped snapshot can be restored using the UNDROP SNAPSHOT command.

    • After the Time Travel retention period, it is permanently removed; it must be recreated.

    For more information, see Período de retenção de dados.

  • To immediately drop a snapshot without retention, set DATA_RETENTION_TIME_IN_DAYS to 0 at the schema level where the snapshot resides. This setting also effects the retention period for other objects within that schema.

Exemplos

O exemplo a seguir descarta o instantâneo denominado example_snapshot:

DROP SNAPSHOT example_snapshot;
Copy
+----------------------------------------+
| status                                 |
|----------------------------------------|
| EXAMPLE_SNAPSHOT successfully dropped. |
+----------------------------------------+
Linguagem: Português