この記事では、AI で生成された Unity Catalog オブジェクトとテーブル列のコメント (AI 生成ドキュメントとも呼ばれます) について説明し、そのしくみについて説明し、それらを追加および編集する方法を示します。
重要
コメントを保存すると、 ALTER SQL コマンドがトリガーされ、Azure Databricks のパイプラインとジョブが中断される可能性があります。
AI によって生成されたコメントの背後にある AI の詳細については、 Databricks AI 支援機能の信頼と安全性に関するページを参照してください。
サポート対象のオブジェクト
AI が生成したコメントは、次の Unity Catalog オブジェクトでサポートされています。
- カタログ
- スキーマ
- 表
- テーブル列
- Functions
- モデル
- ボリューム
AI によって生成されたコメントは、ビューや具体化されたビューに対応していません。
AI によって生成されたコメントはどのように機能しますか?
オブジェクトを変更するアクセス許可を持つオブジェクト所有者またはユーザーは、カタログ エクスプローラーを使用して、Unity Catalog で管理されているオブジェクトおよびテーブル列に対して、AI が生成したコメントを表示および追加できます。 コメントは、テーブル スキーマや列名など、オブジェクト メタデータを考慮する大規模言語モデル (LLM) によって提供されます。
AI によって生成されたコメントは、ユーザーが Unity カタログで管理されるデータを検出するのに役立つ、簡単な方法を提供します。
重要
AI が生成したコメントは、スキーマに基づいてオブジェクトとテーブル列の一般的な説明を提供することを目的としています。 この説明は、さまざまな業界にわたるいくつかのオープン データ セットのスキーマ例を使用して、ビジネスおよびエンタープライズ コンテキストのデータ向けに調整されています。 このモデルは、有害または不適切な説明の生成の回避を検証するために、数百件のシミュレートされたサンプルを使用して評価されています。
AI モデルは必ずしも正確であるとは限らないため、コメントは、保存する前にレビューする必要があります。 Databricks では、AI によって生成されたコメントを人間がレビューして不正確さをチェックすることを強く推奨しています。 このモデルは、PII を含む列の検出などのデータ分類タスクに使用しないでください。
追加されたコメントを表示するには、オブジェクトに対する SELECT 権限、親スキーマに対する USE SCHEMA 権限、親カタログに対する USE CATALOG 権限が必要です。
AI によって生成されるコメントは、 Databricks AI 支援機能です。 コメント候補の生成に使用されるモデルの詳細については、 パートナーを利用した AI 機能 と Databricks AI 支援機能の信頼と安全性に関するセクションを参照してください。
AI によって生成されたコメントを追加する
カタログ エクスプローラーを使用して、提案されたコメントを表示して編集し、オブジェクトとテーブル列にそれらを追加する必要があります。
必要なアクセス許可: AI が推奨するコメントを表示し、編集して追加するには、オブジェクト所有者であるか、オブジェクトに対する MODIFY 権限を持っている必要があります。
AI が推奨するコメントをオブジェクトに追加する
Azure Databricks ワークスペースで、[
![データ] アイコンをクリックします。](../_static/images/product-icons/dataicon.svg)
カタログ。オブジェクトを検索または参照して選択します。
[この
<object>について] パネルで、[AI 生成] をクリックします。
AI がコメントを生成するまでに少し時間がかかる場合があります。
コメントをそのまま受け入れる場合は [Accept] (承諾) をクリックし、保存する前に変更するには [編集] をクリックします。
AI が推奨するコメントをテーブル列に追加する
Azure Databricks ワークスペースで、[
カタログ。テーブルを検索または参照して選択します。
テーブルの列見出しの上にある [AI 生成] をクリックします。
列ごとにコメントが生成されます。
列コメントの横にあるチェック マークをクリックして受け入れるか、未保存で閉じます。
AI によって生成されたコメントを更新する
オブジェクトに対する MODIFY 権限を持つオブジェクト所有者またはユーザーは、カタログ エクスプローラー UI を使用して、いつでもコメントを更新できます。 インライン チャット アシスタントは、コメントの編集に役立ち、テキストを短縮したり、別の言語にテキストを翻訳したりするオプションを提供します。
ALTER または COMMENT ON SQL コマンドを使用することもできます。
プライバシーとセキュリティ
プライバシーとセキュリティに関する FAQ については、 AI 支援機能に関するプライバシーとセキュリティに関する FAQ を参照してください。