DROP STAGE

Remove o estágio nomeado interno ou externo especificado do esquema atual/especificado. O status dos arquivos no estágio depende do tipo de estágio:

  • Para um estágio interno, todos os arquivos do estágio são purgados do Snowflake, independentemente de seu estado de carregamento. Isso impede que os arquivos continuem a usar o armazenamento e, consequentemente, acumulem encargos de armazenamento. Entretanto, isto também significa que os arquivos preparados não podem ser recuperados depois que um estágio é descartado.

  • Para um estágio externo, apenas o estágio em si é descartado; quaisquer arquivos de dados no local externo referenciado (Amazon S3, Google Cloud Storage ou Microsoft Azure) não são removidos.

Consulte também:

CREATE STAGE , ALTER STAGE , SHOW STAGES , DESCRIBE STAGE

Sintaxe

DROP STAGE [ IF EXISTS ] <name>
Copy

Parâmetros

name

Especifica o identificador do estágio 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. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Notas de uso

  • Os estágios descartados não podem ser recuperados; eles devem ser recriados.

  • Este comando não pode ser usado para descartar o estágio associado a uma tabela ou usuário; somente estágios nomeados (internos ou externos) podem ser descartados.

Exemplos

DROP STAGE my_stage;

--------------------------------+
             status             |
--------------------------------+
 MY_STAGE successfully dropped. |
--------------------------------+
Copy