AI が生成したコメントを Unity Catalog オブジェクトに追加する
この記事では、AI によって生成された Unity Catalog オブジェクトとテーブル列のコメント (AI によって生成されたドキュメントとも呼ばれます) を紹介し、それらがどのように機能するかを説明し、それらを追加および編集する方法を示し、よく寄せられる質問に回答します。
コメントを保存すると、 ALTER SQL コマンドがトリガーされ、Databricks のパイプラインとジョブが中断される可能性があります。
サポートされているオブジェクト
AI によって生成されたコメントは、次の Unity Catalog オブジェクトでサポートされています。
- カタログ
- スキーマ
- テーブル
- テーブルの列
- 関数
- モデル
- ボリューム
AI が生成したコメントは、ビューやマテリアライズドビューをサポートしていません。
AIが生成したコメントはどのように機能しますか?
オブジェクトの所有者またはオブジェクトを変更する権限を持つユーザーは、カタログエクスプローラを使用して、Unity Catalog によって管理されるオブジェクトとテーブル列の AI 生成コメントを表示および追加できます。 コメントは、テーブル スキーマや列名などのアカウント オブジェクトのメタデータを取り込む大規模言語モデル (LLM) によって強化されます。
AI が生成するコメントは、ユーザーが Unity Catalog によって管理されているデータをすばやく見つけるのに役立ちます。
AI が生成するコメントは、スキーマに基づいてオブジェクトとテーブル列の一般的な説明を提供することを目的としています。 説明は、さまざまな業界のいくつかのオープンデータセットの例スキーマを使用して、ビジネスおよびエンタープライズのコンテキストでのデータに合わせて調整されています。 このモデルは、有害または不適切な説明の生成を回避することを確認するために、数百のシミュレートされたサンプルで評価されました。
AIモデルは常に正確であるとは限らず、コメントは保存する前に確認する必要があります。 Databricks では、AI が生成したコメントを人間がレビューして不正確さをチェックすることを強くお勧めします。 このモデルは、PII を使用した列の検出などのデータ分類タスクには依存しないでください。
コメントが追加されたときに表示するには、オブジェクトに対する SELECT 権限、親スキーマに対する USE SCHEMA 、および親カタログに対する USE CATALOG 権限が必要です。
コメントの提案を生成するために使用されるモデルに関する情報については、「AIで生成されたコメントについてよく寄せられる質問」を参照してください。
始める前に
AI によって生成されたコメントを使用するには、ワークスペースで AI 支援機能を有効にする必要があります。 ほとんどのワークスペースでは、これはデフォルトで有効になっています。 ただし、ワークスペースで コンプライアンス セキュリティ プロファイルを使用している場合、ワークスペース管理者はパートナー向けの AI 支援機能を有効にする必要があります。
- 設定 で、 詳細設定 タブに移動し、 その他 セクションまで下にスクロールします。
- パートナーが提供する AI 支援機能 オプションをオンにします。
AIが生成したコメントを追加する
カタログエクスプローラを使用して、提案されたコメントを表示し、編集し、オブジェクトやテーブルの列に追加する必要があります。
必要な権限 : AI が提案するコメントを表示、編集、および追加するには、オブジェクトの所有者であるか、オブジェクトに対する MODIFY 権限を持っている必要があります。
AI が提案するコメントをオブジェクトに追加する
-
Databricks ワークスペースで、[
カタログ] をクリックします。 -
オブジェクトを検索または参照して選択します。
-
この
<object>について パネルで、 AI生成 をクリックします。
AI がコメントを生成するのに少し時間がかかる場合があります。
-
承諾 をクリックしてコメントをそのまま受け入れるか、 編集 をクリックしてコメントを変更する前に保存します。
AI が提案するコメントをテーブル列に追加する
-
Databricks ワークスペースで、[
カタログ] をクリックします。 -
テーブルを検索または参照して選択します。
-
テーブルの列見出しの上にある AI 生成 をクリックします。
列ごとにコメントが生成されます。
-
列のコメントの横にあるチェックマークをクリックして、コメントを受け入れるか、保存せずに閉じます。
AI が生成したコメントを更新する
オブジェクトの所有者またはオブジェクトに対する MODIFY 権限を持つユーザーは、カタログエクスプローラのUI を使用して、いつでもコメントを更新できます。 インラインチャットアシスタントは、コメントの編集を支援し、 テキストを短くしたり 、テキストを別の言語に 翻訳 したりするオプションを提供します。
ALTER または COMMENT ON SQL コマンドを使用することもできます。
AI が生成したコメントについてよく寄せられる質問
このセクションでは、AI が生成したコメント (AI が生成したドキュメントとも呼ばれます) に関する一般的な情報を、よくある質問の形式で提供します。
AI生成ドキュメンテーション機能はどのサービスを使用しますか?
コンプライアンス セキュリティ プロファイルが有効になっているワークスペースでは、AI によって生成されたコメントで外部モデル パートナーを使用して応答を提供する場合があります。
AWS 上の他のすべてのワークスペースでは、AI が生成したコメントは、テーブルと列に内部の大規模言語モデル (LLM) を使用します。 他の Unity Catalog オブジェクトやインライン アシスタントに外部モデル パートナーを使用する場合があります。
モデルが内部モデルか外部モデルかに関係なく、これらのモデルに送信されたデータはモデルのトレーニングには使用されません。 モデル自体はステートレスであり、プロンプトや入力候補はモデルプロバイダによって保存されません。
モデルサービングエンドポイントはどのリージョンでホストされていますか?
欧州連合(EU)のデータは EU 内に留まります。 外部パートナー モデルの場合、欧州連合 (EU) ワークスペースは EU でホストされている外部モデルを使用します。 他のすべての地域では、米国でホストされている外部モデルが使用されます。 内部 Databricks モデルの場合、欧州連合 (EU) ワークスペースは eu-west-1でホストされているモデルを使用します。 他のすべてのトラフィックは、パブリック プレビュー中に us-west-2 リージョンに送信されます。
Databricks と外部モデルパートナーの間でデータはどのように暗号化されますか?
Databricks と外部モデルパートナー間のトラフィックは、業界標準の TLS 1.2 暗号化を使用して転送中に暗号化されます。
保存時にはすべて暗号化されていますか?
Databricks ワークスペース内に格納されるデータはすべて AES-256 ビットで暗号化されます。 外部パートナーは、送信されたプロンプトや完了を保存しません。
モデルにはどのようなデータが送信されますか?
Databricks は、各 API 要求で次のメタデータをモデルに送信します。
- カタログ (カタログ名、現在のコメント、カタログの種類)
- スキーマ (カタログ名、スキーマ名、現在のコメント)
- テーブル (カタログ名、スキーマ名、テーブル名、現在のコメント)
- 関数 (カタログ名、スキーマ名、関数名、現在のコメント、パラメーター、定義)
- モデル (カタログ名、スキーマ名、モデル名、現在のコメント、エイリアス)
- ボリューム (カタログ名、スキーマ名、ボリューム名、現在のコメント)
- カラム名(カラム名、タイプ、プライマリキーかどうか、現在のカラムコメント)
承認されたコメントは、Unity Catalog の残りのメタデータと共に Databricks コントロール プレーン データベースに格納されます。 コントロールプレーンデータベースはAES-256ビットで暗号化されています。
AIが生成したコメントの使用にはどのような法律用語が規定されていますか?
使用は、お客様がDatabricksを使用する際に同意した既存のDatabricks契約条件に準拠します。