Поделиться через

SHOW TABLES DROPPED

  • Статья

Область применения:флажок Databricks SQL флажок Databricks Runtime 12.2 LTS и выше

Внимание

Эта функция предоставляется в режиме общедоступной предварительной версии.

Эта команда показывает все таблицы, которые были удалены из схемы в Unity Catalog, но все еще могут быть восстановлены. В частности, он перечисляет все удаленные таблицы в течение периода хранения (по умолчанию — 7 дней). Если схема или каталог удалены, возникает ошибка. Если схема не указана, таблицы возвращаются из текущей схемы.

Команда будет перечислять только таблицы, которые запрашивающий может UNDROP. Следовательно, владельцы метахранилищ, каталогов или схем имеют право перечислять все удаленные таблицы в пределах своей области управления доступом. Пользователи с правами владения на уровне таблицы смогут просматривать таблицы, принадлежащие им в исходном каталоге/схеме, если у них есть привилегия USE CATALOG на родительский каталог и привилегия USE SCHEMA на родительскую схему.

Синтаксис

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

Параметры

  • schema_name

    Указывает имя схемы, из которой должны быть перечислены таблицы. Если не указано, используется текущая схема. Если схема или каталог не существует или удалена, возникает ошибка SCHEMA_NOT_FOUND.

  • maxResult

    Целочисленный литерал, ограничивающий количество возвращаемых таблиц.

Возвраты

Команда создает отчет списка таблиц со следующими столбцами:

Имя. Тип данных Допускает значение NULL Описание"
catalogName STRING no Имя каталога указанной таблицы.
schemaName STRING no Имя схемы указанной таблицы.
tableName STRING no Имя исключённой таблицы
tableId STRING no Идентификатор таблицы, который можно использовать для идентификации и удаления определенной версии удаленной таблицы.
tableType STRING no Тип удаленной таблицы в каталоге Unity
deletedAt STRING no Время, когда стол был уронен.
createdAt STRING no Время создания таблицы.
updatedAt STRING no Время последнего обновления таблицы.
createdBy STRING no Субъект, создавший таблицу.
владелец STRING no Субъект, которому принадлежит таблица.
Комментарий STRING yes Необязательный комментарий таблицы.

Примеры

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