Udostępnij za pośrednictwem

SHOW TABLES DROPPED

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 12.2 LTS i nowsze

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

To polecenie wyświetla listę wszystkich tables, które zostały porzucone w schema w środowisku Unity Catalog, ale nadal można je usunąć. W szczególności wyświetla listę wszystkich porzuconych tables w okresie przechowywania (wartość domyślna to 7 dni). Jeśli schema lub catalog zostały porzucone, zostanie zgłoszony błąd. Jeśli nie zdefiniowano schema, to tables są zwracane z obecnego schema.

Polecenie zostanie listtables, które wnioskujący może cofnąć usunięcie. W rezultacie właściciele metastore/catalog/schema mają uprawnienia do list wszystkich usuniętych tables, które są częścią ich zabezpieczonych zasobów. Użytkownicy z poziomem własności table będą mogli wyświetlać tylko tables, których są właścicielami, w wejściowych catalog/schema, o ile mają uprawnienie USE CATALOG w nadrzędnym catalog oraz uprawnienie USE SCHEMA w nadrzędnym schema.

Składnia

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

Parameters

  • schema_name

    Określa nazwę schema, z której ma być wyświetlana tables. Jeśli nie zostanie podana, użyj bieżącego schema. Jeśli schema lub catalog nie istnieje lub został porzucony, zostanie zgłoszony błąd SCHEMA_NOT_FOUND.

  • maxResult

    Literał liczby całkowitej ograniczający ilość zwróconych tables.

Zwraca

Polecenie s generuje raport o list dotyczący tables z następującymi columns:

Nazwisko Typ danych Dopuszczający wartość null Opis"
catalogName STRUNA nie Nazwa catalog wymienionej table.
schemaName STRUNA nie Nazwa schema dla wymienionego table.
tableName STRUNA nie Nazwa porzuconych table
tableId STRUNA nie Identyfikator table, który może służyć do identyfikacji i przywracania określonej wersji usuniętego table.
tableType STRUNA nie Typ porzuconych table w środowisku Unity Catalog
deletedAt STRUNA nie Czas, kiedy table został wycofany.
createdAt STRUNA nie Czas utworzenia table.
updatedAt STRUNA nie Czas, kiedy table został ostatnio zaktualizowany.
createdBy STRUNA nie Osoba lub podmiot, który utworzył table.
owner STRUNA nie Zleceniodawca, który jest właścicielem table.
comment STRUNA tak Opcjonalny komentarz table.

Przykłady

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