AFFICHER DES TABLES SUPPRIMÉES

S’applique à : Databricks SQL Databricks Runtime 12.2 LTS et versions ultérieures

Important

Cette fonctionnalité est disponible en préversion publique.

Cette commande répertorie toutes les tables qui ont été supprimées dans le schéma dans Unity Catalog, mais qui peuvent toujours ne pas être supprimées. Plus précisément, il répertorie toutes les tables supprimées au cours de la période de rétention (7 jours par défaut). Si le schéma ou le catalogue ont été supprimés, une erreur est générée. Si aucun schéma n’est spécifié, les tables sont retournées à partir du schéma actuel.

La commande répertorie uniquement les tables que le demandeur peut UNDROP. Par conséquent, les propriétaires de metastore/catalogue/schéma disposent de privilèges pour répertorier toutes les tables supprimées dans leur propriété sécurisable respective. Les utilisateurs qui sont propriétaires d’une table peuvent uniquement visualiser les tables dont ils sont propriétaires dans le catalogue/schéma d’entrée, sous réserve qu’ils disposent du privilège USE CATALOG sur le catalogue parent et du privilège USE SCHEMA sur le schéma parent.

Syntaxe

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

Paramètres

• schema_name

  Spécifie le nom du schéma à partir duquel les tables doivent être listées. S’il n’est pas fourni, utilise le schéma actuel. Si le schéma ou le catalogue n’existent pas ou ont été supprimé, une erreur SCHEMA_NOT_FOUND est générée.

• maxResult

  Un littéral entier limitant le nombre de tables retournées.

Retours

La commande s produit un rapport de la liste des tables avec les colonnes suivantes :

Name	Data Type	Nullable	Description”
catalogName	STRING	non	Le nom du catalogue de la table répertoriée.
schemaName	STRING	non	Le nom de schéma de la table répertoriée.
tableName	STRING	non	Le nom de la table supprimée
tableId	STRING	non	L’ID de table qui peut être utilisé pour identifier et annuler la suppression d’une version spécifique de la table supprimée.
tableType	STRING	non	Le type de la table supprimée dans Unity Catalog
deletedAt	STRING	non	L’heure à laquelle la table a été supprimée.
createdAt	STRING	non	L’heure à laquelle la table a été créée.
updatedAt	STRING	non	L’heure à laquelle la table a été mise à jour pour la dernière fois.
createdBy	STRING	non	Le principal qui a créé la table.
Propriétaire	STRING	non	Le principal propriétaire de la table.
commentaire	STRING	Oui	Les commentaires facultatifs de la table.

Exemples

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

Articles connexes

• SHOW TABLES
• UNDROP