Partilhar via

Enriqueça tabelas Delta Lake com metadados personalizados

  • Artigo

O Databricks recomenda sempre fornecer comentários para tabelas e colunas em tabelas. Você pode gerar esses comentários usando IA. Consulte Adicionar comentários gerados por IA a objetos do Catálogo Unity.

O Unity Catalog também fornece a capacidade de marcar dados. Consulte Aplicar tags a objetos protegíveis do Unity Catalog.

Você também pode registrar mensagens para confirmações individuais em tabelas em um campo no log de transações do Delta Lake.

Definir metadados de confirmação definidos pelo usuário

Você pode especificar cadeias de caracteres definidas pelo usuário como metadados em confirmações, usando a opção userMetadata DataFrameWriter ou a configuração spark.databricks.delta.commitInfo.userMetadataSparkSession. Se ambos tiverem sido especificados, a opção terá preferência. Esses metadados definidos pelo usuário podem ser lidos DESCRIBE HISTORY na operação. Veja Trabalhar com o histórico de tabelas do Delta Lake.

SQL


SET spark.databricks.delta.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")