VISA BORTTAGNA TABELLER
Gäller för:
Databricks SQL Databricks Runtime 12.2 LTS och senare
Viktigt!
Den här funktionen finns som allmänt tillgänglig förhandsversion.
Det här kommandot visar alla tabeller som har släppts i schemat i Unity Catalog, men som fortfarande kan avregistreras. Mer specifikt visas alla borttagna tabeller inom kvarhållningsperioden (standardvärdet är 7 dagar). Om schemat eller katalogen har tagits bort utlöses ett fel. Om inget schema anges returneras tabellerna från det aktuella schemat.
Kommandot visar endast tabeller som beställaren kan UNDROP.
Därför har metaarkiv-/katalog-/schemaägare behörighet att lista alla borttagna tabeller inom deras respektive skyddsbara ägarskap.
Användare med ägarskap på tabellnivå kan bara visa tabeller som de äger i indatakatalogen/schemat så länge de har behörigheten USE CATALOG för den överordnade katalogen och behörigheten USE SCHEMA för det överordnade schemat.
Syntax
SHOW TABLES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]
Parametrar
-
Anger schemanamnet som tabellerna ska visas från. Om det inte anges använder du det aktuella schemat. Om schemat eller katalogen inte finns eller har tagits bort utlöses ett SCHEMA_NOT_FOUND fel.
maxResult
En heltalsliteral som begränsar antalet returnerade tabeller.
Returer
Kommandot s genererar en rapport över listan över tabeller med följande kolumner:
| Name | Datatyp | Kan ha värdet null | Beskrivning" |
|---|---|---|---|
| catalogName | STRÄNG | nej | Katalognamnet för den angivna tabellen. |
| schemaName | STRÄNG | nej | Schemanamnet för den angivna tabellen. |
| tableName | STRÄNG | nej | Namnet på den borttagna tabellen |
| tableId | STRÄNG | nej | Det tabell-ID som kan användas för att identifiera och undsläppa en specifik version av den borttagna tabellen. |
| tableType | STRÄNG | nej | Typen av borttagen tabell i Unity Catalog |
| deletedAt | STRÄNG | nej | Tiden då tabellen togs bort. |
| createdAt | STRÄNG | nej | Tiden då tabellen skapades. |
| updatedAt | STRÄNG | nej | Den tid då tabellen senast uppdaterades. |
| createdBy | STRÄNG | nej | Huvudnamnet som skapade tabellen. |
| ägare | STRÄNG | nej | Huvudnamnet som äger tabellen. |
| kommentar | STRÄNG | ja | Den valfria tabellkommenten. |
Exempel
— 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
----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------