DROP DYNAMIC TABLE

Remove uma tabela dinâmica do esquema atual/especificado.

Consulte também:

CREATE DYNAMIC TABLE, ALTER DYNAMIC TABLE, DESCRIBE DYNAMIC TABLE, SHOW DYNAMIC TABLES, UNDROP DYNAMIC TABLE

Neste tópico:

Sintaxe

DROP DYNAMIC TABLE [ IF EXISTS ] <name>
Copy

Parâmetros

name

Especifica o identificador da tabela dinâmica a ser descartada. 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 da tabela não estiver totalmente qualificado (na forma de db_name.schema_name.table_name ou schema_name.table_name), o comando procura a tabela no esquema atual para a sessão.

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

A tabela dinâmica que você deseja descartar.

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um 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 descartar uma tabela dinâmica, você deve usar uma função que tenha o privilégio OWNERSHIP nessa tabela dinâmica.

  • Você também pode remover uma tabela dinâmica usando o comando DROP TABLE.

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

Exemplos

Drop the dynamic table named product:

DROP DYNAMIC TABLE product;
Copy
DROP TABLE product;
Copy