Comentários sobre tabelas externas

A Lakehouse Federation pode sincronizar comentários de tabelas e colunas de fontes de dados externas suportadas para tabelas estrangeiras no Unity Catalog. Comentários sincronizados aparecem nos metadados das tabelas, incluindo Explorador de Catálogo, DESCRIBE, e DESCRIBE EXTENDED saída.

Requirements

• Computação: Utilize o Databricks Runtime 18.2 ou superior, ou um armazém SQL num canal em que seja executada a versão 2026.15 do Databricks SQL ou superior. Ver canais de armazém SQL.

Fontes de dados suportadas

Os comentários das tabelas estrangeiras são sincronizados para as seguintes fontes de dados:

• Google BigQuery

• Federação do metastore do Hive

• MySQL

• Oracle no Databricks Runtime 18 LTS ou superior

  Note

  O Databricks Runtime 18 é mais recente do que o Databricks Runtime 18.0, 18.1 e 18.2. Funcionalidades que anteriormente seriam enviadas como versões numeradas posteriores agora são enviadas como atualizações datadas do Databricks Runtime 18. Para mais detalhes, consulte Sobre as notas de lançamento unificadas.

• PostgreSQL

• Amazon Redshift

• Federação de consulta Snowflake e federação do catálogo Snowflake

• Teradata

• Federação do catálogo OneLake em Databricks Runtime 18 LTS ou superior

Os comentários das tabelas estrangeiras não são sincronizados para as seguintes fontes de dados:

• Azure Synapse (Armazém de Dados SQL)
• Federação de consultas Databricks-para-Databricks
• Microsoft SQL Server
• Partilha de ficheiros Salesforce Data 360 e Salesforce Data 360

Sincronizar comentários da fonte externa

Para fontes de dados suportadas, o Azure Databricks recolhe comentários de tabelas estrangeiras quando resolve metadados de tabelas estrangeiras no momento da consulta. Quando os comentários mudam na fonte externa, os comentários atualizados são sincronizados na próxima vez que uma consulta resolve a tabela estrangeira.

Para sincronizar comentários sem fazer uma consulta aos dados da tabela, execute DESCRIBE EXTENDED na tabela estrangeira:

DESCRIBE EXTENDED <catalog-name>.<schema-name>.<table-name>;

Desligue a busca de comentários

Defina a enableForeignCommentFetching opção de catálogo para false saltar a sobrecarga de resolução de metadados da busca de comentários para fontes MySQL, Oracle, PostgreSQL, Amazon Redshift, Snowflake e Teradata. A opção é true por defeito. Defina-o usando a OPTIONS cláusula quando criar ou alterar um catálogo. O Explorador de Catálogos não expõe esta opção.

Quando desativado, o Azure Databricks preserva os comentários já armazenados no Unity Catalog, mas não sincroniza comentários novos ou alterados da fonte estrangeira.