DESCRIBE DETAILによりテーブルの詳細を確認する

DESCRIBE DETAILを使用して、Delta LakeまたはApache Icebergテーブルに関する詳細なメタデータ（ファイル数、データサイズ、パーティション列、有効なテーブル機能を含む）を取得します。

例えば：

SQL

DESCRIBE DETAIL '/data/events/'

DESCRIBE DETAIL eventsTable

Spark SQL構文の詳細については、「DESCRIBE DETAIL」を参照してください。

Scala/Java/Python の構文の詳細については、Delta Lake API のドキュメントを参照してください。

スキーマの詳細

注記

表示される列は、使用している Databricks Runtime のバージョンと有効にしているテーブル機能によって異なります。

DESCRIBE DETAIL操作の出力には、次のスキーマを持つ1行のみがあります。

列	Type	説明
format	string	テーブルの形式（たとえば、deltaまたはiceberg）です。
id	string	テーブルの一意の ID。
name	string	メタストアで定義されているテーブルの名前。
description	string	テーブルの説明。
location	string	テーブルの場所。
createdAt	timestamp	テーブルが作成されたとき。
lastModified	timestamp	テーブルが最後に変更された時刻。
partitionColumns	文字列の配列	テーブルがパーティション分割されている場合のパーティション列の名前。
numFiles	long	テーブルの最新バージョンでのファイル数。
sizeInBytes	int	テーブルの最新スナップショットのサイズ（バイト単位）。
properties	文字列-文字列マップ	このテーブルに設定されているすべてのプロパティです。
minReaderVersion	int	テーブルを読み取り可能な（ログプロトコルに準拠した）読み取り元の最小バージョン。
minWriterVersion	int	テーブルに書き込めるライターの最小バージョン（ログプロトコルに基づく）。
statistics	文字列のキーを持つマップ	追加のテーブルレベルの統計
tableFeatures	文字列の配列	テーブルでサポートされているテーブル機能の一覧。Delta Lake 機能の互換性とプロトコルを参照してください。
clusteringColumns	文字列の配列	リキッドクラスタリングに使用されているカラム。テーブルにリキッドクラスタリングを使用するを参照してください。

出力例:

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