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 deze opdracht worden alle tables weergegeven die in de schema in Unity Catalogzijn verwijderd, maar die nog steeds kunnen worden hersteld. Specifiek worden alle tables-gevallen die binnen de bewaarperiode zijn weggevallen vermeld (de standaard is 7 dagen). Als de schema of catalog zijn weggevallen, ontstaat er een fout. Als er geen schema is opgegeven, worden de tables geretourneerd uit de huidige schema.

Met de opdracht wordt alleen listtables welke de aanvrager kan UNDROP. Daarom hebben metastore/catalog/schema eigenaren privileges om te list voor alle verwijderde tables binnen de eigendommen die zij beveiligd kunnen bezitten. Gebruikers met table niveaueigendom kunnen alleen tables bekijken waarvan ze eigenaar zijn binnen de invoer catalog/schema, zolang ze de bevoegdheid USE CATALOG hebben voor de bovenliggende catalog en de bevoegdheid USE SCHEMA voor de bovenliggende schema.

Syntaxis

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

Parameters

  • schema_name

    Hiermee geeft u de naam schema op van waaruit tables worden weergegeven. Als dit niet is opgegeven, gebruikt u de huidige schema. Als de schema of catalog niet bestaan of zijn verwijderd, treedt er een SCHEMA_NOT_FOUND fout op.

  • maxResult

    Een letterlijk geheel getal dat het aantal geretourneerde tables beperkt.

Retouren

De opdracht s produceert een rapport van de list van tables met de volgende columns:

Naam Gegevenstype Null-waarde toegestaan Beschrijving"
catalogName STRING nee De catalog naam van de vermelde table.
schemaName STRING nee De schema naam van de vermelde table.
tableName STRING nee De naam van de verwijderde table
tableId STRING nee De table-ID die kan worden gebruikt om een specifieke versie van de verwijderde tablete identificeren en terug te zetten.
tableType STRING nee Het type verwijderde table in Unity Catalog
deletedAt STRING nee De tijd waarop de table werd verwijderd.
createdAt STRING nee Het tijdstip waarop de table is gemaakt.
updatedAt STRING nee Het tijdstip waarop de table voor het laatst is bijgewerkt.
createdBy STRING nee De directeur die de tableheeft gemaakt.
eigenaar STRING nee De principal die eigenaar is van de table.
reactie STRING ja De optionele table opmerking.

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