DROP TABLE

Van toepassing op:check marked yes Databricks SQL check marked yes 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 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.

Eventuele beperkingen voor refererende sleutels 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 ervan ongedaan.

Notitie

Wanneer een beheerde tabel uit Unity Catalog wordt verwijderd, worden de onderliggende gegevens binnen 30 dagen verwijderd uit uw cloudtenant.

Syntaxis

DROP TABLE [ IF EXISTS ] table_name

Parameter

  • INDIEN AANWEZIG

    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 bevatten. Als de tabel niet kan worden gevonden, genereert Azure Databricks een TABLE_OR_VIEW_NOT_FOUND fout.

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;