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