SHOW TABLES DROPPED

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 12.2 LTS y versiones posteriores

Importante

Esta característica está en versión preliminar pública.

Este comando enumera todas las tablas que se han quitado dentro del esquema en el catálogo de Unity, pero todavía se pueden recuperar. En concreto, enumera todas las tablas quitadas dentro del período de retención (el valor predeterminado es 7 días). Si se ha quitado el esquema o el catálogo, se genera un error. Si no se especifica ningún esquema, se devuelven las tablas del esquema actual.

El comando solo mostrará las tablas que sobre las que el solicitante pueda hacer UNDROP. Por lo tanto, los propietarios de metastore, catálogo o esquema tienen privilegios para enumerar todas las tablas quitadas dentro de su propiedad protegible respectiva. Los usuarios con propiedad de nivel de tabla solo podrán ver las tablas que poseen en el catálogo o esquema de entrada siempre que tengan el privilegio USE CATALOG en el catálogo primario y el privilegio USE SCHEMA en el esquema primario.

Sintaxis

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

Parámetros

  • schema_name

    Especifica el nombre del esquema a partir de la cual se mostrarán las tablas. Si no se proporciona, utiliza el esquema actual. Si el esquema o catálogo no existe o se ha quitado, se genera un error de SCHEMA_NOT_FOUND.

  • maxResult

    Literal entero que limita el número de tablas devueltas.

Devoluciones

El comando genera un informe de la lista de tablas con las columnas siguientes:

Nombre Tipo de datos Admisión de valores NULL Descripción”
catalogName STRING no Nombre de catálogo de la tabla enumerada.
schemaName STRING no Nombre de esquema de la tabla enumerada.
tableName STRING no Nombre de la tabla quitada
tableId STRING no Identificador de tabla que se puede usar para identificar y quitar una versión específica de la tabla quitada.
tableType STRING no El tipo de la tabla quitada en el catálogo de Unity
deletedAt STRING no Hora en que se quitó la tabla.
createdAt STRING no Hora en que se creó la tabla.
updatedAt STRING no Hora en que se actualizó por última vez la tabla.
createdBy STRING no Entidad de seguridad que creó la tabla.
owner STRING no La entidad de seguridad que posee la tabla.
comentario STRING sí Comentario de tabla opcional.

Ejemplos

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