DROP EXTERNAL TABLE (Transact-SQL)
Aplica-se a: SQL Server 2016 (13.x) e posterior Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics
Remove uma tabela externa do PolyBase de um banco de dados, mas não exclui os dados externos.
Convenções de sintaxe de Transact-SQL
Sintaxe
DROP EXTERNAL TABLE { database_name.schema_name.table_name | schema_name.table_name | table_name }
[;]
Argumentos
[ database_name . [schema_name] . | schema_name . ] table_name
O nome de uma a três partes da tabela externa a ser removida. O nome da tabela pode incluir, opcionalmente, o esquema, ou o banco de dados e o esquema.
Permissões
Exige:
- A permissão ALTER no esquema ao qual a tabela pertence.
- ALTER ANY EXTERNAL DATA SOURCE
- ALTER ANY EXTERNAL FILE FORMAT
Comentários
A remoção de uma tabela externa remove todos os metadados relacionados à tabela. Ela não exclui os dados externos.
Exemplos
a. Usando a sintaxe básica
DROP EXTERNAL TABLE SalesPerson;
DROP EXTERNAL TABLE dbo.SalesPerson;
DROP EXTERNAL TABLE EasternDivision.dbo.SalesPerson;
B. Removendo uma tabela externa do banco de dados atual
O exemplo a seguir remove a tabela ProductVendor1
, seus dados, índices e todas as exibições dependentes do banco de dados atual.
DROP EXTERNAL TABLE ProductVendor1;
C. Removendo uma tabela de outro banco de dados
O exemplo a seguir descarta a tabela SalesPerson
no banco de dados EasternDivision
.
DROP EXTERNAL TABLE EasternDivision.dbo.SalesPerson;