DROP EXTERNAL VOLUME¶
Remove um volume externo da conta, mas mantém uma versão do volume externo para que possa ser recuperado usando UNDROP EXTERNAL VOLUME. Para mais informações, consulte Notas de uso (neste tópico).
- Consulte também:
CREATE EXTERNAL VOLUME , ALTER EXTERNAL VOLUME , SHOW EXTERNAL VOLUMES , DESCRIBE EXTERNAL VOLUME
Sintaxe¶
DROP EXTERNAL VOLUME [ IF EXISTS ] <name>
Parâmetros¶
nameEspecifica o identificador do volume externo a ser descartado. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, toda a cadeia de caracteres deve ser delimitada por aspas duplas (por exemplo,
"My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.
Requisitos de controle de acesso¶
Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:
Privilégio |
Objeto |
Notas |
|---|---|---|
OWNERSHIP |
Volume externo |
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). |
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 descarte de um volume externo não o remove permanentemente do sistema. Snowflake mantém uma versão do volume externo descartado no Time Travel. Você pode restaurar um volume externo descartado usando o comando UNDROP EXTERNAL VOLUME.
Após a eliminação de um volume externo descartado, ele não poderá ser recuperado; ele deverá ser recriado.
Após descartar um volume externo, a criação de um volume externo com o mesmo nome cria uma nova versão do volume externo. Você pode restaurar a versão descartada do volume externo anterior seguindo estas etapas:
Renomeie a versão atual do volume externo.
Use o comando UNDROP EXTERNAL VOLUME para restaurar a versão anterior.
Exemplos¶
O exemplo a seguir descarta um volume externo chamado my_external_volume:
DROP EXTERNAL VOLUME my_external_volume;