Udostępnij za pośrednictwem

POKAŻ USUNIĘTE TABELE

  • 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 tabel, które zostały porzucone w schemacie w wykazie aparatu Unity, ale nadal można je usunąć. W szczególności wyświetla listę wszystkich porzuconych tabel w okresie przechowywania (wartość domyślna to 7 dni). Jeśli schemat lub wykaz został porzucony, zostanie zgłoszony błąd. Jeśli nie określono schematu, tabele są zwracane z bieżącego schematu.

Polecenie wyświetli tylko tabele, które moduł żądający może cofnąć. W związku z tym właściciele magazynu metadanych/katalogu/schematu mają uprawnienia do wyświetlania listy wszystkich porzuconych tabel w ramach odpowiedniej zabezpieczanej własności. Użytkownicy z własnością na poziomie tabeli będą mogli wyświetlać tylko tabele, które należą do katalogu danych wejściowych/schematu, o ile mają USE CATALOG uprawnienia do katalogu nadrzędnego i USE SCHEMA uprawnienia w schemacie nadrzędnym.

Składnia

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

Parametry

  • schema_name

    Określa nazwę schematu, z której mają być wyświetlane tabele. Jeśli nie zostanie podany, użyj bieżącego schematu. Jeśli schemat lub wykaz nie istnieje lub został porzucony, zostanie zgłoszony błąd SCHEMA_NOT_FOUND .

  • maxResult

    Literał liczby całkowitej ograniczający liczbę zwracanych tabel.

Zwraca

Polecenie tworzy raport listy tabel z następującymi kolumnami:

Nazwisko Typ danych Dopuszczający wartość null Opis"
catalogName STRUNA nie Nazwa katalogu wymienionej tabeli.
schemaName STRUNA nie Nazwa schematu wymienionej tabeli.
tableName STRUNA nie Nazwa usuniętej tabeli
tableId STRUNA nie Identyfikator tabeli, który może służyć do identyfikowania i cofania określonej wersji usuniętej tabeli.
tableType STRUNA nie Typ usuniętej tabeli w wykazie aparatu Unity
deletedAt STRUNA nie Czas, kiedy tabela została porzucona.
createdAt STRUNA nie Godzina utworzenia tabeli.
updatedAt STRUNA nie Czas ostatniej aktualizacji tabeli.
createdBy STRUNA nie Podmiot zabezpieczeń, który utworzył tabelę.
owner STRUNA nie Podmiot zabezpieczeń, który jest właścicielem tabeli.
comment STRUNA tak Opcjonalny komentarz do tabeli.

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