DROP TABLE

A következőkre vonatkozik: Databricks SQL Databricks Runtime

Törli a táblát, és eltávolítja a táblához társított könyvtárat a fájlrendszerből, ha a tábla nem EXTERNAL tábla. A rendszer kivételt okoz, ha a tábla nem létezik. Egy tábla elvetéséhez MANAGE jogosultsággal kell rendelkeznie a táblán, annak tulajdonosának vagy a tábla séma-, katalógus- vagy metaadattárának tulajdonosának kell lennie.

Külső tábla esetén csak a kapcsolódó metaadat-információk törlődnek a metaadattár sémájából.

A táblára hivatkozó idegenkulcs-megkötések is elvetve lesznek.

Ha a tábla gyorsítótárazva van, a parancs törli a táblát és annak összes gyorsítótárazott függőjét.

Megjegyzés

A táblák 7–30 napon belül törlődnek. A Unity Catalog támogatja azt a UNDROP TABLE parancsot, amely 7 napig helyreállítja az elvetett felügyelt táblákat. 7 nap elteltével az alapul szolgáló adatok törlésre kerülnek a felhőbeli bérlői fiókból a rendszeres táblakarbantartási műveletek során.

Szintaxis

DROP [ TEMPORARY ] TABLE [ IF EXISTS ] table_name [ FORCE ]

Paraméter

• IDEIGLENES

  A következőre vonatkozik: Databricks SQL Databricks Runtime 17.3 és újabb

  Töröl egy TEMPORARY táblát.

• HA LÉTEZIK

  Ha meg van adva, a TABLE_OR_VIEW_NOT_FOUND hiba nem jelenik meg, ha a tábla nem létezik.

• table_name

  Az eldobandó tábla neve. A név nem tartalmazhat időbeli specifikációt vagy beállításspecifikációt. Ha a tábla nem található, az Azure Databricks TABLE_OR_VIEW_NOT_FOUND hibát jelez. Ha a talált kapcsolat nem tábla, az Azure Databricks WRONG_COMMAND_FOR_OBJECT_TYPE hibát jelez.

• ERŐ

  Ha meg van adva, a táblázat akkor is törölhető, ha függő, felületes klónokkal rendelkezik. Ez csak a Unity Catalog által felügyelt táblákra vonatkozik. Lásd : Egy sekély klón alaptáblájának elvetése.

Példák

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

Kapcsolódó cikkek

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