Commentaires sur les tables étrangères

Lakehouse Federation peut synchroniser les commentaires des tables et des colonnes depuis des sources de données externes prises en charge vers des tables étrangères dans Unity Catalog. Les commentaires synchronisés apparaissent dans les métadonnées des tables, notamment dans Catalog Explorer, DESCRIBE et la sortie DESCRIBE EXTENDED.

Requirements

• Calcul : utilisez Databricks Runtime 18.2 ou version ultérieure, ou un entrepôt SQL sur un canal qui exécute Databricks SQL version 2026.15 ou ultérieure. Consultez les canaux SQL Warehouse.

Sources de données prises en charge

Les commentaires des tables externes sont synchronisés pour les sources de données suivantes :

• Google BigQuery

• Fédération du métastore Hive

• MySQL

• Oracle sur Databricks Runtime 18 LTS ou version ultérieure

  Remarque

  Databricks Runtime 18 est plus récent que Databricks Runtime 18.0, 18.1 et 18.2. Les fonctionnalités qui auraient auparavant été publiées dans une version ultérieure numérotée sont désormais publiées sous forme de mises à jour datées de Databricks Runtime 18. Pour plus d’informations, consultez À propos des notes de publication unifiées.

• PostgreSQL

• Décalage vers le rouge de l’Amazon

• Fédération des requêtes Snowflake et fédération du catalogue Snowflake

• Teradata

• Fédération de catalogues OneLake sur Databricks Runtime 18 LTS ou version ultérieure

Les commentaires de table étrangère ne sont pas synchronisés pour les sources de données suivantes :

• Azure Synapse (sql Data Warehouse)
• Fédération de requêtes Databricks-to-Databricks
• Microsoft SQL Server
• Partage de fichiers Salesforce Data 360 et Salesforce Data 360

Synchroniser les commentaires à partir de la source externe

Pour les sources de données prises en charge, Azure Databricks extrait les commentaires de table étrangère lorsqu’il résout les métadonnées de table étrangère au moment de la requête. Lorsque les commentaires changent dans la source externe, les commentaires mis à jour sont synchronisés la prochaine fois qu’une requête résout la table étrangère.

Pour synchroniser les commentaires sans exécuter de requête sur les données de la table, exécutez-les DESCRIBE EXTENDED sur la table étrangère :

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

Désactivez la récupération des commentaires

Configurez l’option enableForeignCommentFetching catalogue pour false éviter la surcharge de résolution des métadonnées liée à la récupération de commentaires pour MySQL, Oracle, PostgreSQL, Amazon Redshift, Snowflake et Teradata. L’option est true par défaut. Définissez-la en utilisant la OPTIONS clause lorsque vous créez ou modifiez un catalogue. L’Explorateur de catalogue n’affiche pas cette option.

Lorsqu'il est désactivé, Azure Databricks conserve les commentaires déjà stockés dans Unity Catalog mais ne synchronise pas les commentaires nouveaux ou modifiés provenant de la source étrangère.