DROP TABLE

Van toepassing op: Databricks SQL Databricks Runtime

Hiermee verwijdert u de tabel en verwijdert u de map die aan de tabel is gekoppeld uit het bestandssysteem als de tabel geen EXTERNAL tabel is. Er wordt een uitzondering gegenereerd als de tabel niet bestaat. Als u een tabel wilt verwijderen, moet u de bevoegdheid MANAGE voor de tabel hebben, de eigenaar zijn of de eigenaar van het schema, de catalogus of de metastore waarin de tabel zich bevindt.

In het geval van een externe tabel worden alleen de bijbehorende metagegevensgegevens verwijderd uit het metastore-schema.

Foreign key-beperkingen die naar de tabel verwijzen, worden ook verwijderd.

Als de tabel in de cache is opgeslagen, maakt de opdracht de cache van de tabel en alle afhankelijke items ongedaan.

Syntaxis

DROP TABLE [ IF EXISTS ] table_name [ FORCE ]

Kenmerk

• ALS BESTAAT

  Als dit is opgegeven, wordt er geen TABLE_OR_VIEW_NOT_FOUND fout gegenereerd wanneer de tabel niet bestaat.

• table_name

  De naam van de tabel die moet worden verwijderd. De naam mag geen tijdelijke specificatie of optiesspecificatie bevatten. Als de tabel niet kan worden gevonden, genereert Azure Databricks een TABLE_OR_VIEW_NOT_FOUND-fout. Als de gevonden relatie geen tabel is, genereert Azure Databricks een WRONG_COMMAND_FOR_OBJECT_TYPE fout.

• KRACHT

  Indien opgegeven kan de tabel zelfs worden verwijderd als deze afhankelijke ondiepe klonen heeft. Dit is alleen van toepassing op door Unity Catalog beheerde tabellen. Zie De basistabel verwijderen voor een ondiepe kloon.

Voorbeelden

-- Assumes a table named `employeetable` exists.
> DROP TABLE employeetable;

-- Assumes a table named `employeetable` exists in the `userdb` schema
> DROP TABLE userdb.employeetable;

-- Assumes a table named `employeetable` does not exist.
-- Throws TABLE_OR_VIEW_NOT_FOUND
> DROP TABLE employeetable;
  Error: TABLE_OR_VIEW_NOT_FOUND

-- Assumes a table named `employeetable` does not exist,Try with IF EXISTS
-- this time it will not throw exception
> DROP TABLE IF EXISTS employeetable;

-- Assumes a table named `employeetable` exists and has a shallow clone.
-- Throws CANNOT_DROP_BASE_TABLE_REFERENCED_BY_SHALLOW_CLONE
> DROP TABLE employeetable;
  Error: CANNOT_DROP_BASE_TABLE_REFERENCED_BY_SHALLOW_CLONE

-- Assumes a table named `employeetable` exists and has a shallow clone.
-- Drops base table, but shallow clones referencing this base table will no longer work
> DROP TABLE employeetable FORCE;

Verwante artikelen:

• CREATE TABLE
• CREATE SCHEMA
• DROP SCHEMA
• UNDROP TABLE