Delen via

SHOW TABLES DROPPED

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 12.2 LTS en hoger

Belangrijk

Deze functie is beschikbaar als openbare preview.

Met dit commando worden alle tabellen weergegeven die binnen het schema in Unity Catalog zijn verwijderd, maar die nog steeds kunnen worden hersteld. In het bijzonder worden alle verwijderde tabellen in de bewaarperiode vermeld (standaard is 7 dagen). Als het schema of de catalogus is verwijderd, treedt er een fout op. Als er geen schema is opgegeven, worden de tabellen geretourneerd uit het huidige schema.

Met het commando worden alleen tabellen weergegeven die de aanvrager in staat is om te UNDROP. Daarom hebben metastore-/catalogus-/schema-eigenaren bevoegdheden om alle verwijderde tabellen op te sommen binnen hun respectieve beveiligde eigendom. Gebruikers met eigendom op tabelniveau kunnen alleen tabellen bekijken waarvan ze eigenaar zijn in de invoercatalogus/het schema zolang ze de USE CATALOG bevoegdheid hebben voor de bovenliggende catalogus en de USE SCHEMA bevoegdheid voor het bovenliggende schema.

Syntaxis

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

Parameters

  • schema_name

    Hiermee geeft u de schemanaam van waaruit tabellen moeten worden weergegeven. Als dit niet is opgegeven, gebruikt u het huidige schema. Als het schema of de catalogus niet bestaat of is verwijderd, wordt er een SCHEMA_NOT_FOUND fout gegenereerd.

  • maxResult

    Een letterlijk geheel getal dat het aantal geretourneerde tabellen beperkt.

Retouren

De opdracht produceert een rapport van de lijst met tabellen met de volgende kolommen:

Naam Gegevenstype Null-waarde toegestaan Beschrijving"
catalogName STRING nee De catalogusnaam van de vermelde tabel.
schemaName STRING nee De schemanaam van de vermelde tabel.
tableName STRING nee De naam van de verwijderde tabel
tableId STRING nee De tabel-id die kan worden gebruikt om een specifieke versie van de verwijderde tabel te identificeren en los te laten.
tableType STRING nee Het type van de verwijderde tabel in Unity Catalog
deletedAt STRING nee Het tijdstip waarop de tabel werd verwijderd.
createdAt STRING nee Het tijdstip waarop de tabel is gemaakt.
updatedAt STRING nee Het tijdstip waarop de tabel voor het laatst is bijgewerkt.
createdBy STRING nee De principal die de tabel heeft gemaakt.
eigenaar STRING nee De principal die eigenaar is van de tabel.
reactie STRING ja De optionele tabelcommentaar.

Voorbeelden

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