DROP STREAMLIT

Remove o objeto Streamlit especificado do esquema atual/especificado.

Consulte também:

CREATE STREAMLIT, SHOW STREAMLITS, DESCRIBE STREAMLIT, UNDROP STREAMLIT, ALTER STREAMLIT

Sintaxe

DROP STREAMLIT [IF EXISTS] <name>
Copy

Parâmetros obrigatórios

name

Especifica o identificador do objeto Streamlit 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 (por exemplo, "My Object").

Se o identificador do objeto Streamlit não estiver totalmente qualificado (na forma de db_name.schema_name.streamlit_name ou schema_name.streamlit_name), o comando procura o objeto Streamlit no esquema atual para a sessão.

Requisitos de controle de acesso

Sua função deve ter os seguintes privilégios em objetos:

Privilégio

Objeto

OWNERSHIP

Objeto Streamlit que você remove

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

  • Para objetos Streamlit criados usando ROOT_LOCATION, esse comando não descarta o estágio subjacente porque o proprietário do objeto Streamlit pode não ser o proprietário do estágio. Além disso, vários objetos Streamlit podem apontar para o mesmo estágio. Se você precisar descartar o estágio correspondente, use o comando DROP STAGE.

  • 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.