Comentários sobre tabelas estrangeiras

Important

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

O Lakehouse Federation pode sincronizar comentários de tabelas e colunas de fontes de dados externas compatíveis com tabelas estrangeiras no Catálogo do Unity. Os comentários sincronizados aparecem nos metadados da tabela, incluindo o Explorador de Catálogo, DESCRIBE, e a saída DESCRIBE EXTENDED.

Requirements

  • Computação: use o Databricks Runtime 18.2 ou superior ou um SQL warehouse em um canal que execute o Databricks SQL versão 2026.15 ou superior. Consulte os canais do SQL Warehouse.

Fontes de dados com suporte

Os comentários de tabelas externas são sincronizados nas seguintes fontes de dados:

Os comentários de tabela estrangeira não são sincronizados para as seguintes fontes de dados:

Sincronizar comentários da origem externa

Para fontes de dados com suporte, o Azure Databricks busca comentários de tabelas estrangeiras quando resolve metadados de tabelas estrangeiras no momento da consulta. Quando os comentários são alterados na origem externa, os comentários atualizados são sincronizados na próxima vez que uma consulta resolver a tabela estrangeira.

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

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

Desative a busca de comentários

Defina a enableForeignCommentFetching opção de catálogo para false pular 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 padrão. Defina usando a OPTIONS cláusula quando você criar ou alterar um catálogo. O Explorador de Catálogos não expõe essa 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.