Partilhar via

MOSTRAR TABELAS DESCARTADAS

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime 12.2 LTS e superior

Importante

Esta funcionalidade está em Pré-visualização Pública.

Este comando lista todas as tabelas que foram descartadas dentro do esquema no Unity Catalog, mas ainda podem ser descartadas. Especificamente, ele lista todas as tabelas descartadas dentro do período de retenção (o padrão é 7 dias). Se o esquema ou o catálogo tiverem sido descartados, um erro será gerado. Se nenhum esquema for especificado, as tabelas serão retornadas do esquema atual.

O comando listará apenas as tabelas que o solicitante é capaz de UNDROP. Consequentemente, os proprietários de metastore/catálogo/esquema têm privilégios para listar todas as tabelas descartadas dentro de sua respetiva propriedade protegível. Os usuários com propriedade em nível de tabela só poderão exibir tabelas que possuem dentro do catálogo/esquema de entrada, desde que tenham o USE CATALOG privilégio no catálogo pai e o USE SCHEMA privilégio no esquema pai.

Sintaxe

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

Parâmetros

  • schema_name

    Especifica o nome do esquema a partir do qual as tabelas devem ser listadas. Se não for fornecido, usa o esquema atual. Se o esquema ou catálogo não existir ou tiver sido descartado, um erro de SCHEMA_NOT_FOUND será gerado.

  • maxResultado

    Um literal inteiro limitando o número de tabelas retornadas.

Devoluções

O comando s produz um relatório da lista de tabelas com as seguintes colunas:

Name Tipo de Dados Pode ser nulo Descrição"
nome_do_catálogo STRING não O nome do catálogo da tabela listada.
schemaName STRING não O nome do esquema da tabela listada.
tableName STRING não O nome da tabela descartada
tableId STRING não O ID da tabela que pode ser usado para identificar e descartar uma versão específica da tabela descartada.
tipo de tabela STRING não O tipo da tabela descartada no Unity Catalog
suprimidoEm STRING não O tempo em que a mesa foi abandonada.
criadosAt STRING não A hora em que a tabela foi criada.
atualizadoem STRING não A hora em que a tabela foi atualizada pela última vez.
criadopor STRING não O diretor que criou a tabela.
proprietário STRING não O diretor que é o dono da mesa.
comentário STRING sim O comentário da tabela opcional.

Exemplos

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