ОТОБРАЖЕНИЕ ТАБЛИЦ, УДАЛЕННЫХ

  • Статья

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

Внимание

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

Эта команда содержит список всех таблиц, которые были удалены в схеме в каталоге Unity, но по-прежнему могут быть отменены. В частности, он перечисляет все удаленные таблицы в течение периода хранения (по умолчанию — 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
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------