カスタムメタデータでテーブルを充実させる
Databricks では、テーブルとテーブル内の列に常にコメントを提供することをお勧めします。 これらのコメントは、AI を使用して生成できます。 AI で生成されたコメントを Unity Catalog オブジェクトに追加するを参照してください。
Unity Catalog には、データにタグを付ける機能もあります。 「 Unity Catalog のセキュリティ保護可能なオブジェクトにタグを適用する」を参照してください。
トランザクション ログのフィールドに、テーブルへの個々のコミットのメッセージを記録します。
ユーザー定義のコミット メタデータを設定する
DataFrameWriter オプションuserMetadataまたは SparkSession 構成spark.databricks.delta.commitInfo.userMetadata (Delta) またはspark.databricks.iceberg.commitInfo.userMetadata (Iceberg) を使用して、コミット内のメタデータとしてユーザー定義の文字列を指定します。両方が指定されている場合は、オプションが優先されます。このユーザー定義のメタデータは、 DESCRIBE HISTORY操作で読み取り可能です。「テーブル履歴の操作」を参照してください。
- SQL
- Python
- Scala
SQL
-- For Delta tables
SET spark.databricks.delta.commitInfo.userMetadata=some-comment
INSERT OVERWRITE target_table SELECT * FROM data_source
-- For Iceberg tables
SET spark.databricks.iceberg.commitInfo.userMetadata=some-comment
INSERT OVERWRITE target_table SELECT * FROM data_source
Python
df.write \
.mode("overwrite") \
.option("userMetadata", "some-comment") \
.table("target_table")
Scala
df.write
.mode("overwrite")
.option("userMetadata", "some-comment")
.table("target_table")