Condividi tramite

SHOW TABLES DROPPED

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 12.2 LTS e versioni successive

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Questo comando elenca tutte le tabelle che sono state eliminate all'interno dello schema in Unity Catalog, ma che possono comunque essere ripristinate. In particolare, elenca tutte le tabelle eliminate entro il periodo di conservazione (il valore predefinito è 7 giorni). Se lo schema o il catalogo sono stati eliminati, viene generato un errore. Se non viene specificato alcuno schema, le tabelle vengono restituite dallo schema corrente.

Il comando elencherà solo le tabelle che il richiedente è in grado di UNDROP. Di conseguenza, i proprietari di metastore/catalog/schema hanno i privilegi per elencare tutte le tabelle eliminate nell'ambito della loro proprietà sicura. Gli utenti con proprietà a livello di tabella potranno visualizzare solo le tabelle di cui sono proprietari all'interno del catalogo o dello schema di input, purché dispongano del privilegio USE CATALOG nel catalogo padre e del privilegio USE SCHEMA nello schema padre.

Sintassi

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

Parametri

  • schema_name

    Specifica il nome dello schema da cui elencare le tabelle. Se non specificato, usa lo schema corrente. Se lo schema o il catalogo non esiste o è stato eliminato, viene generato un errore SCHEMA_NOT_FOUND.

  • maxResult

    Valore letterale integer che limita il numero di tabelle restituite.

Valori restituiti

Il comando genera un report dell'elenco di tabelle con le colonne seguenti:

Nome Tipo di dati Nullable Descrizione"
catalogName STRING no Nome del catalogo della tabella elencata.
schemaName STRING no Nome dello schema della tabella elencata.
tableName STRING no Nome della tabella eliminata
tableId STRING no L'ID tabella che può essere usato per identificare e ripristinare una versione specifica della tabella eliminata.
tableType STRING no Tipo della tabella eliminata in Unity Catalog
deletedAt STRING no Ora in cui la tabella è stata eliminata.
createdAt STRING no Ora di creazione della tabella.
updatedAt STRING no Ora dell'ultimo aggiornamento della tabella.
createdBy STRING no Il principale che ha creato la tabella.
owner STRING no Il preside che possiede la tabella.
commento STRING yes Commento facoltativo della tabella.

Esempi

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