メインコンテンツまでスキップ

AI が生成したコメントを Unity Catalog オブジェクトに追加する

この記事では、AI によって生成された Unity Catalog オブジェクトとテーブル列のコメント (AI によって生成されたドキュメントとも呼ばれます) を紹介し、それらがどのように機能するかを説明し、それらを追加および編集する方法を示します。

important

コメントを保存すると、 ALTER SQL コマンドがトリガーされ、Databricks のパイプラインとジョブが中断される可能性があります。

AI によって生成されたコメントの背後にある AI の詳細については、「 Databricks AI 機能の信頼性と安全性」を参照してください。

サポートされているオブジェクト​

AI によって生成されたコメントは、次の Unity Catalog オブジェクトでサポートされています。

  • カタログ
  • スキーマ
  • テーブル
  • テーブルの列
  • 関数
  • モデル
  • ボリューム

AI が生成したコメントは、ビューやマテリアライズドビューをサポートしていません。

AIが生成したコメントはどのように機能しますか?​

オブジェクトの所有者またはオブジェクトを変更する権限を持つユーザーは、カタログエクスプローラを使用して、Unity Catalog によって管理されるオブジェクトとテーブル列の AI 生成コメントを表示および追加できます。 コメントは、テーブル スキーマや列名などのアカウント オブジェクトのメタデータを取り込む大規模言語モデル (LLM) によって強化されます。

AI が生成するコメントは、ユーザーが Unity Catalog によって管理されているデータをすばやく見つけるのに役立ちます。

important

AI が生成するコメントは、スキーマに基づいてオブジェクトとテーブル列の一般的な説明を提供することを目的としています。 説明は、さまざまな業界のいくつかのオープンデータセットの例スキーマを使用して、ビジネスおよびエンタープライズのコンテキストでのデータに合わせて調整されています。 このモデルは、有害または不適切な説明の生成を回避することを確認するために、数百のシミュレートされたサンプルで評価されました。

AIモデルは常に正確であるとは限らず、コメントは保存する前に確認する必要があります。 Databricks では、AI が生成したコメントを人間がレビューして不正確さをチェックすることを強くお勧めします。 このモデルは、PII を使用した列の検出などのデータ分類タスクには依存しないでください。

コメントが追加されたときに表示するには、オブジェクトに対する SELECT 権限、親スキーマに対する USE SCHEMA 、および親カタログに対する USE CATALOG 権限が必要です。

コメントの提案を生成するために使用されるモデルに関する情報については、 FAQ を参照してください。

始める前に​

AI によって生成されたコメントを使用するには、ワークスペースで AI 支援機能を有効にする必要があります。 ほとんどのワークスペースでは、これはデフォルトで有効になっています。 ただし、ワークスペースで コンプライアンス セキュリティ プロファイルを使用している場合、ワークスペース管理者はパートナー向けの AI 支援機能を有効にする必要があります。

  1. 設定 で、 詳細設定 タブに移動し、 その他 セクションまで下にスクロールします。
  2. パートナーが提供する AI 支援機能 オプションをオンにします。
important

テーブルと列の場合のみ、 AI コメントはデフォルトによって機能し、 パートナーが提供する AI 支援機能 によって制御されません。 詳細については、「パートナーが提供する AI 支援機能 の設定によって管理される機能」を参照してください。

AIが生成したコメントを追加する​

カタログエクスプローラを使用して、提案されたコメントを表示し、編集し、オブジェクトやテーブルの列に追加する必要があります。

必要な権限 : AI が提案するコメントを表示、編集、および追加するには、オブジェクトの所有者であるか、オブジェクトに対する MODIFY 権限を持っている必要があります。

AI が提案するコメントをオブジェクトに追加する​

  1. Databricks ワークスペースで、[データアイコン。 カタログ] をクリックします。

  2. オブジェクトを検索または参照して選択します。

  3. この <object>について パネルで、 AI生成 をクリックします。

    AIが生成したコメントボタン

    AI がコメントを生成するのに少し時間がかかる場合があります。

  4. 承諾 をクリックしてコメントをそのまま受け入れるか、 編集 をクリックしてコメントを変更する前に保存します。

AI が提案するコメントをテーブル列に追加する​

  1. Databricks ワークスペースで、[データアイコン。 カタログ] をクリックします。

  2. テーブルを検索または参照して選択します。

  3. テーブルの列見出しの上にある AI 生成 をクリックします。

    列ごとにコメントが生成されます。

  4. 列のコメントの横にあるチェックマークをクリックして、コメントを受け入れるか、保存せずに閉じます。

AI が生成したコメントを更新する​

オブジェクトの所有者またはオブジェクトに対する MODIFY 権限を持つユーザーは、カタログエクスプローラのUI を使用して、いつでもコメントを更新できます。 インラインチャットアシスタントは、コメントの編集を支援し、 テキストを短くしたり 、テキストを別の言語に 翻訳 したりするオプションを提供します。

AIが生成するコメントインラインアシスタント

ALTER または COMMENT ON SQL コマンドを使用することもできます。

Unity Catalog オブジェクトに対する AI 生成コメントに関する FAQ​

このセクションでは、Unity Catalog オブジェクトに対する AI 生成コメント (AI 生成ドキュメントとも呼ばれます) に関する一般的な情報を、よくある質問の形式で提供します。

AIが生成したコメント機能はどのサービスを使用しますか?​

テーブルとテーブル列の AI 生成コメント (AI 生成ドキュメントとも呼ばれます) は、 パートナー提供の AI が有効になっている場合、Azure OpenAI サービスを使用します。 パートナー向け AI をオフにすると、AI コメントは Databricks でホストされるモデルを使用します。

他の AI 生成コメントに使用されるモデルなど、詳細については、「パートナーが提供する AI 支援機能 設定によって管理される機能」を参照してください。

モデルサービングエンドポイントはどのリージョンでホストされていますか?​

欧州連合(EU)のデータは EU 内に留まります。外部パートナー モデルの場合、欧州連合 (EU) ワークスペースは EU でホストされている外部モデルを使用します。他のすべての地域では、米国でホストされている外部モデルが使用されます。

モデルにはどのようなデータが送信されますか?​

Databricks は、各 API 要求で次のメタデータをモデルに送信します。

  • カタログ (カタログ名、現在のコメント、カタログの種類)
  • スキーマ (カタログ名、スキーマ名、現在のコメント)
  • テーブル (カタログ名、スキーマ名、テーブル名、現在のコメント)
  • 関数 (カタログ名、スキーマ名、関数名、現在のコメント、パラメーター、定義)
  • モデル (カタログ名、スキーマ名、モデル名、現在のコメント、エイリアス)
  • ボリューム (カタログ名、スキーマ名、ボリューム名、現在のコメント)
  • カラム名(カラム名、タイプ、プライマリキーかどうか、現在のカラムコメント)

承認されたコメントは、Unity Catalog の残りのメタデータと共に Databricks コントロール プレーン データベースに格納されます。 コントロールプレーンデータベースはAES-256ビットで暗号化されています。

に最終更新