Freigeben über

DROP TABLE

  • Artikel

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Löscht die Tabelle und entfernt das der Tabelle zugeordnete Verzeichnis aus dem Dateisystem, wenn die Tabelle keine EXTERNAL-Tabelle ist. Wenn die Tabelle nicht vorhanden ist, wird eine Ausnahme ausgelöst. Um eine Tabelle zu löschen, müssen Sie über die MANAGE-Berechtigung für die Tabelle verfügen, ihr Besitzer oder der Besitzer des Schemas, des Datenbankkatalogs oder der Metadatenbank sein, in dem sich die Tabelle befindet.

Im Falle einer externen Tabelle werden nur die zugehörigen Metadaten aus dem Metastore-Schema entfernt.

Alle Fremdschlüsseleinschränkungen, die auf die Tabelle verweisen, werden ebenfalls gelöscht.

Wenn die Tabelle zwischengespeichert ist, werden die Tabelle und alle von ihr abhängigen Elemente aus dem Zwischenspeicher entfernt.

Hinweis

Wenn eine verwaltete Tabelle von Unity Catalog gelöscht wird, werden die zugrunde liegenden Daten innerhalb von 30 Tagen aus Ihrem Cloudmandanten gelöscht.

Syntax

DROP TABLE [ IF EXISTS ] table_name

Parameter

  • IF EXISTS

    Wird dieser Parameter angegeben, wird kein TABLE_OR_VIEW_NOT_FOUND-Fehler ausgelöst, wenn die Tabelle nicht vorhanden ist.

  • table_name

    Der Name der zu verwerfenden Tabelle. Der Name darf keine zeitliche Spezifikation oder Optionsspezifikation enthalten. Wenn die Tabelle nicht gefunden werden kann, löst Azure Databricks den Fehler TABLE_OR_VIEW_NOT_FOUND aus.

Beispiele

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