メインコンテンツまでスキップ
に最終更新

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

このページでは、 AIによって生成されたUnity Catalogオブジェクトおよびテーブルの列コメント（ AI生成ドキュメントとも呼ばれます）を紹介し、その仕組みを説明し、追加および編集方法を示します。

重要

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

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

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

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

  • カタログ
  • スキーマ
  • テーブル
  • ビュー
  • マテリアライズドビュー
  • テーブルの列
  • 関数
  • モデル
  • ボリューム

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

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

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

AIが生成するコメントを有効または無効にするための、ワークスペースレベルまたはカタログレベルの切り替え機能はありません。カタログエクスプローラーを通じてリクエストすると、オブジェクトごとにコメントが生成されます。Databricksが提案コメントを生成した後、それを確認し、そのまま受け入れるか、保存する前に編集することができます。

重要

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

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

追加されたコメントを表示するには、カタログに対するBROWSE権限が必要です。BROWSE使用すると、 USE CATALOGまたはUSE SCHEMA権限を必要とせずに、コメントを含むオブジェクト メタデータを表示できます。

AI 生成コメントは、Databricks AI 支援機能です。コメント提案の生成に使用されるモデルについては、 「パートナーによるAI機能」およびDatabricks AI支援機能の信頼性と安全性」を参照してください。

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

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

必要な権限 :

  • ほとんどのオブジェクト (カタログ、スキーマ、テーブル、関数、モデル、ボリューム) の場合: オブジェクトの所有者であるか、オブジェクトに対するMODIFY権限を持っている必要があります。
  • ビューとマテリアライズドビューの場合: オブジェクトの所有者である必要があります。

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

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

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

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

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

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

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

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

  1. Databricks ワークスペースで、[データアイコン。 カタログ] をクリックします。
  2. テーブルを検索または参照して選択します。
  3. 表の列見出しの上にある 「AI生成」 をクリックします。各列ごとにコメントが生成されます。
  4. 列のコメントの横にあるチェックマークをクリックして、コメントを受け入れるか、保存せずに閉じます。

AIが生成するコメントのデフォルト言語を変更する​

安心により、 AIによって生成されたコメントは、 Databricksワークスペース UI 設定で設定された言語で書かれます。 AIが提案する説明文 カードの言語セレクターを使用することで、この設定を上書きできます。選択内容はブラウザのローカルストレージに保存され、サポートされているすべてのエンティティタイプにおける、以降のすべてのAI生成コメントリクエストに適用されます。

AIによる説明候補のオーバーフローメニューに言語セレクターを追加。

言語を変更するには：

  1. コメントを生成したら、ケバブメニューのアイコン。 AIが提案する説明文 カードの右上隅にあるオーバーフローメニューアイコン。
  2. クリック地球儀のアイコン。 デフォルト言語を変更します 。
  3. リストから言語を選択してください。

次回、サポートされているオブジェクトに対してコメントを生成する際、Databricksは選択された言語を使用します。

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

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

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

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

プライバシーとセキュリティ​

プライバシーとセキュリティに関する FAQ については、 AI 支援機能のプライバシーとセキュリティに関する FAQ をご覧ください。

このページの見出し