Freigeben über

SHOW TABLES DROPPED

  • Artikel

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 12.2 LTS und höher

Wichtig

Dieses Feature befindet sich in der Public Preview.

Dieser Befehl listet alle Tabellen auf, die innerhalb des Schemas in Unity Catalog gelöscht wurden, deren Löschung aber wieder aufgehoben werden kann. Insbesondere werden alle gelöschten Tabellen innerhalb des Aufbewahrungszeitraums aufgelistet (Standardeinstellung: 7 Tage). Wenn das Schema oder der Katalog gelöscht wurde, wird ein Fehler ausgelöst. Wird kein Schema angegeben, werden Tabellen aus dem aktuellen Schema zurückgegeben.

Der Befehl listet nur Tabellen auf, für die die anfordernde Person einen Vorgang vom Typ UNDROP ausführen kann. Daher haben Metastore-/Katalog-/Schemabesitzer*innen die Berechtigung, alle gelöschten Tabellen in ihrem jeweiligen sicherungsfähigen Besitz aufzulisten. Benutzer und Benutzerinnen mit Besitz auf Tabellenebene können nur Tabellen anzeigen, die sie im Eingabekatalog/-schema besitzen, sofern sie über die Berechtigungen USE CATALOG für den übergeordneten Katalog und die Berechtigungen USE SCHEMA für das übergeordnete Schema verfügen.

Syntax

SHOW TABLES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]

Parameter

  • schema_name

    Gibt den Namen des Schemas an, deren Tabellen aufgelistet werden sollen. Falls nicht angegeben, wird das aktuelle Schema verwendet. Wenn das Schema oder der Katalog nicht vorhanden ist oder gelöscht wurde, wird ein Fehler vom Typ SCHEMA_NOT_FOUND ausgelöst.

  • maxResult

    Ein Integer-Literal, das die Anzahl der zurückgegebenen Tabellen begrenzt.

Gibt zurück

Der Befehl erzeugt einen Bericht der Tabellenliste mit den folgenden Spalten:

Name Datentyp Nullable Beschreibung
catalogName STRING Nein Der Katalogname der aufgeführten Tabelle
schemaName STRING Nein Der Schemaname der aufgeführten Tabelle
tableName STRING Nein Der Name der gelöschten Tabelle
tableId STRING Nein Die Tabellen-ID, mit der eine bestimmte Version der gelöschten Tabelle ermittelt und wiederhergestellt werden kann.
tableType STRING Nein Der Typ der gelöschten Tabelle in Unity Catalog
deletedAt STRING Nein Der Zeitpunkt, zu dem die Tabelle gelöscht wurde
createdAt STRING Nein Der Zeitpunkt, zu dem die Tabelle erstellt wurde
updatedAt STRING Nein Der Zeitpunkt, zu dem die Tabelle zuletzt aktualisiert wurde
createdBy STRING Nein Der Prinzipal, der die Tabelle erstellt hat
owner STRING Nein Der Prinzipal, der die Tabelle besitzt
Kommentar STRING ja Der optionale Tabellenkommentar

Beispiele

— List dropped tables from an existing schema + catalog.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> CREATE TABLE my_table_2;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

-- Create a new table with name `my_table_1` since other was dropped.
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED IN default.my_schema;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

— List dropped tables when some are past the retention period.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
-- Wait 8 days (1 more than 7 day retention period)
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner        comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------