DROP TABLE

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Tar bort tabellen och tar bort katalogen som är associerad med tabellen från filsystemet om tabellen inte är en EXTERNAL tabell. Ett undantag utlöses om tabellen inte finns. Om du vill släppa en tabell måste du ha MANAGE behörighet i tabellen, vara dess ägare eller ägaren av schemat, katalogen eller metaarkivet som tabellen finns i.

När det gäller en extern tabell tas endast den associerade metadatainformationen bort från metaarkivschemat.

Begränsningar för främmande nyckel som refererar till tabellen tas också bort.

Om tabellen cachelagras rensar kommandot tabellen och alla dess beroenden.

Anteckning

Unity Catalog stöder kommandot för att återställa borttagna UNDROP TABLE hanterade tabeller. Som standard kan tabeller återställas i 7 dagar efter att de har tagits bort. När återställningsperioden är slut tas de underliggande datafilerna bort permanent från molnklientorganisationen inom 48 timmar. Du kan konfigurera återställningsperioden på katalog- eller schemanivå. Se Släpp en hanterad tabell och objektlagringslivscykel i Unity Catalog.

Syntax

DROP TABLE [ IF EXISTS ] table_name [ FORCE ]
DROP {TEMP | TEMPORARY} TABLE table_name [IF EXISTS]

Parameter

  • TEMP eller TEMPORARY

    Gäller för:markerad ja Databricks SQL

    Om det anges släpper du den tillfälliga tabellen. Om det inte finns någon tillfällig tabell med det här namnet i sessionen genererar kommandot ett felfel TABLE_OR_VIEW_NOT_FOUND feltillstånd .

    Om det inte anges släpper kommandot bara en permanent tabell och genererar ett fel om det finns en tillfällig tabell med samma okvalificerade namn i sessionen. Om du vill släppa en permanent tabell när en tillfällig tabell delar samma namn använder du det kvalificerade namnet.

  • OM DET FINNS

    Om det anges utlöses inget TABLE_OR_VIEW_NOT_FOUND fel när tabellen inte finns.

  • table_name

    Namnet på tabellen som ska tas bort. Namnet får inte innehålla en temporal specifikation eller alternativspecifikation. Om det inte går att hitta tabellen skapar Azure Databricks ett TABLE_OR_VIEW_NOT_FOUND fel. Om relationen som hittas inte är en tabell genererar Azure Databricks ett WRONG_COMMAND_FOR_OBJECT_TYPE fel.

  • KRAFT

    Om det anges kan tabellen raderas även om den har beroende grunda kloner. Detta gäller endast för hanterade Unity Catalog-tabeller. Se Ta bort grundtabellen för en grundläggande klon.

Exempel

-- 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;

-- Creates and drops a temporary table
> CREATE TEMPORARY TABLE scratchpad(txt STRING);
> DROP TEMPORARY TABLE scratchpad;
  • Last updated on