フォーリンテーブルに関するコメント

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

レイクハウスフェデレーションは、サポートされている外部データソースからテーブルとカラムのコメントをUnity Catalog のフォーリンテーブルに同期できます。同期されたコメントは、カタログエクスプローラー、DESCRIBE、および DESCRIBE EXTENDED の出力を含むテーブルメタデータに表示されます。

要件

• コンピュート : Databricks Runtime 18.2 以降、または Databricks SQLバージョン 2026.15 以降を実行するチャンネルのSQLウェアハウスを使用してください。「SQLウェアハウスのチャンネル」を参照してください。

サポートされているデータソース

フォーリンテーブルのコメントは、次のデータソースに対して同期されます：

• Google BigQuery

• Hive metastore フェデレーション

• MySQL

• Databricks Runtime 18 LTS 以降のOracle

注記

Databricks Runtime 18 は Databricks Runtime 18.0、18.1、および 18.2 より新しいです。以前はより新しい番号のバージョンとして提供されていた機能が、代わりに Databricks Runtime 18 への日付付きアップデートとして提供されます。詳細については、統合リリースノートについてを参照してください。

• PostgreSQL

• Amazon Redshift

• Snowflakeクエリー フェデレーションとSnowflakeカタログ フェデレーション

• テラデータ

フォーリンテーブルのコメントは、以下のデータソースでは同期されません：

• Azure Synapse（SQLデータウェアハウス）
• Databricks-to-Databricks クエリーフェデレーション
• Microsoft SQL Server
• Salesforce データ 360 および Salesforce データ 360 ファイル共有

外部ソースからコメントを同期する

サポートされているデータソースでは、Databricks はクエリ時にフォーリンテーブルのメタデータを解決する際に、フォーリンテーブルのコメントを取得します。外部ソースでコメントが変更された場合、次回クエリがフォーリンテーブルを解決する際に、更新されたコメントが同期されます。

テーブルデータに対してクエリーを実行せずにコメントを同期するには、フォーリンテーブルに対してDESCRIBE EXTENDEDを実行します：

SQL

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

コメントの取得をオフにする

MySQL、Oracle、PostgreSQL、Amazon Redshift、Snowflake、および Teradata ソースのコメント取得におけるメタデータ解決のオーバーヘッドをスキップするには、enableForeignCommentFetching カタログオプションを false に設定します。このオプションは default で true に設定されています。カタログを 作成 または 変更 する際に、OPTIONS 句を使用して設定します。カタログエクスプローラーでは、このオプションは公開されていません。

無効にすると、DatabricksはUnity Catalogに既に保存されているコメントを保持しますが、ソースから新しく追加または変更されたコメントは同期されません。