Examiner les détails de la table avec une description détaillée

Utilisez DESCRIBE DETAIL pour récupérer des métadonnées détaillées sur une table Delta Lake ou Apache Iceberg, notamment le nombre de fichiers, la taille des données, les colonnes de partition et les fonctionnalités de table activées.

Par exemple :

SQL

DESCRIBE DETAIL '/data/events/'

DESCRIBE DETAIL eventsTable

Pour plus de détails sur la syntaxe Spark SQL, veuillez consulter DESCRIBE DETAIL.

Consultez la documentation de l'API Delta Lake pour plus de détails sur la syntaxe Scala/Java/Python.

Détails du schéma

remarque

Les colonnes que vous voyez dépendent de la version de Databricks Runtime que vous utilisez et des fonctionnalités de table que vous avez activées.

Le résultat de l'opération DESCRIBE DETAIL n'a qu'une seule ligne avec le schéma suivant :

Colonne	Type	Description
format	chaîne	Format de la table (par exemple, delta ou iceberg).
id	chaîne	ID unique de la table.
name	chaîne	Nom de la table tel que défini dans le metastore.
description	chaîne	Description de la table.
location	chaîne	Emplacement de la table.
createdAt	Horodatage	Lorsque la table a été créée.
lastModified	Horodatage	Date de la dernière modification du tableau.
partitionColumns	tableau de chaînes	Noms des colonnes de partition si la table est partitionnée.
numFiles	long	Nombre de fichiers dans la dernière version de la table.
sizeInBytes	int	Taille du dernier instantané de la table en octets.
properties	mappage chaîne-chaîne	Toutes les propriétés définies pour cette table.
minReaderVersion	int	Version minimale des lecteurs (selon le protocole de log) qui peuvent lire la table.
minWriterVersion	int	Version minimale des rédacteurs (selon le protocole des logs) qui peuvent écrire dans la table.
statistics	mappage avec des clés de chaîne	Statistiques supplémentaires au niveau de la table.
tableFeatures	tableau de chaînes	Liste des fonctionnalités de table prises en charge par la table. Consultez la compatibilité des fonctionnalités et protocoles Delta Lake.
clusteringColumns	tableau de chaînes	Les colonnes utilisées pour le clustering liquide. Voir Utiliser le clustering liquide pour les tables.

Colonne	Type	Description
format	chaîne	Format de la table (par exemple, delta ou iceberg).
id	chaîne	ID unique de la table.
name	chaîne	Nom de la table tel que défini dans le metastore.
description	chaîne	Description de la table.
location	chaîne	Emplacement de la table.
createdAt	Horodatage	Lorsque la table a été créée.
lastModified	Horodatage	Date de la dernière modification du tableau.
partitionColumns	tableau de chaînes	Noms des colonnes de partition si la table est partitionnée.
numFiles	long	Nombre de fichiers dans la dernière version de la table.
sizeInBytes	int	Taille du dernier instantané de la table en octets.
properties	mappage chaîne-chaîne	Toutes les propriétés définies pour cette table.
minReaderVersion	int	Version minimale des lecteurs (selon le protocole de log) qui peuvent lire la table.
minWriterVersion	int	Version minimale des rédacteurs (selon le protocole des logs) qui peuvent écrire dans la table.
statistics	mappage avec des clés de chaîne	Statistiques supplémentaires au niveau de la table.
tableFeatures	tableau de chaînes	Liste des fonctionnalités de table prises en charge par la table. Consultez la compatibilité des fonctionnalités et protocoles Delta Lake.
clusteringColumns	tableau de chaînes	Les colonnes utilisées pour le clustering liquide. Voir Utiliser le clustering liquide pour les tables.

Résultat d’exemple :

+------+--------------------+------------------+-----------+--------------------+--------------------+-------------------+----------------+--------+-----------+----------+----------------+----------------+
|format|                  id|              name|description|            location|           createdAt|       lastModified|partitionColumns|numFiles|sizeInBytes|properties|minReaderVersion|minWriterVersion|
+------+--------------------+------------------+-----------+--------------------+--------------------+-------------------+----------------+--------+-----------+----------+----------------+----------------+
| delta|d31f82d2-a69f-42e...|default.deltatable|       null|file:/Users/tuor/...|2020-06-05 12:20:...|2020-06-05 12:20:20|              []|      10|      12345|        []|               1|               2|
+------+--------------------+------------------+-----------+--------------------+--------------------+-------------------+----------------+--------+-----------+----------+----------------+----------------+