Partager via

AFFICHER DES TABLES SUPPRIMÉES

  • Article

S’applique à : coche marquée oui Databricks SQL case marquée oui 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
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------