Data Studio設定

このトピックでは、Data StudioツールでのData Studioの設定について説明します。

「Data Studio」ナビゲーション・メニューおよびData Studioの「概要」ページのこの設定では、関連付けられたクラウド・サービスの使用、AIプロファイルの構成、SMTPの構成およびベクトル索引の作成を行うことができます。

これは、ロード中のデータの定義に役立ちます。この設定は、ロードするデータを定義するためのデフォルト資格証明の設定、データ共有用のSMTPの構成、AIプロファイルの構成、マーケットプレイス・クラウド・リンク・アクセスの構成など、様々な全般的なプリファレンスを設定します。

SlackとData Studioの統合により、様々なチーム・メンバー間のリアルタイム・コラボレーションのギャップが解消され、常に情報に基づいた正しい意思決定が可能になります。

Data Studio設定を設定するには、ウィザードの「一般」タブで、マーケットプレイスと共有用にプロファイルを構成するための電子メール・アドレスを指定します。

ウィザードの「クラウド・サービス」タブの「クラウド・オブジェクト・ストア・アクセス」で、次のフィールド値を指定します:

  • OCI資格証明: OCI資格証明を選択すると、OCIバケットを検出できます。「+」をクリックして、OCI資格証明を作成します。
  • OCIコンパートメント: このドロップダウン・フィールドには、Oracleクラウド・サービスからロードおよびリンクする、コンパートメントに存在するバケットがリストされます。Oracle以外の他のクラウド・サービス・プロバイダを選択した場合、このフィールドにはデフォルトで「なし」が表示されます。
  • AWS資格証明: Data Studio設定でAWS資格証明を選択すると、S3バケットを検出できます。「+」をクリックして、Amazon S3クラウド・ストレージの資格証明を作成します。
  • Azure資格証明: プリファレンスでAzure資格証明を選択すると、Azure BLOBストレージを検出できます。「+」をクリックして、Microsoft Azure BLOBストレージおよびAzure Data Lake Storageの資格証明を作成します。
    「オブジェクト・ストア・アクセスのチェック」をクリックして、オブジェクト・ストアへのアクセス権があるかどうかを確認します。次のバケット・リストを含むポリシー・チェック・ウィザードが表示されます:
    • OCIバケットのリスト
    • AWSバケットのリスト
    • Azureバケットのリスト

    オブジェクト・ストレージ・リスト・ポリシー・チェッカは、バケットへのアクセス権があるかどうかを評価します。はいの場合、チェック・ボックスは緑色で強調表示されてチェック・マーク付けられ、そうでない場合は、チェック・ボックスにポリシーが赤色で強調して表示され、赤色の十字が付けられます。

「AI用のクラウド・サービス・プロバイダ」で、ドロップダウン・フィールドから次のいずれかのオプションを選択します:
  • Oracle Cloudインタフェース(OCI)
  • Amazon Web Services (AWS)

「クラウド・サービス・アクセスのチェック」をクリックします。

「クラウド・サービス・ポリシー・チェック」ダイアログ・ボックスに次のオプションが表示されます。次に示すAIクラウド・ポリシーは、リストされているポリシーに対してチェックされ、クラウド・サービス・ベンダーによってサポート対象として承認されている必要があります。Data Studioツールは、これらのサービスをテストし、ツールにロードしたデータでサービスにアクセスできるかどうかを通知します。

Data Studio設定ウィザードのAIプロファイル・タブで、AIプリファレンスを構成できます。

  1. ドロップダウンからAIプロファイルを選択し、このAIプロファイルを使用して、自然言語プロンプトをSQL文に変換する方法をサポートおよび構成します。ドロップダウンには、「AIプロファイルの作成」アイコンから作成したAIプロファイルがリストされます。「+」をクリックしてAIプロファイルを作成します。
    • Data StudioでAIサービスを使用するには、OCI AIOpenAICohereまたはAzure OpenAIサービスのアカウントが必要です。
    • AIプロファイルを設定するには、DBMS_CLOUD_AIパッケージへのアクセス権もある必要があります。
    • OpenAICohereまたはAzure OpenAIサービスのいずれかを使用してSelect AIを設定している場合は、大規模言語モデルによって生成される小さい参照データ表をロードすることで、データを拡張できます。提示されたプロンプトを試すか、独自のプロンプトを作成してAutonomous Databaseにロードするデータを生成します。

      このAIプロファイルを使用して、マーケットプレイス・データセットの説明およびタグを生成することもできます。このAIプロファイルは、カタログ・アプリで表の説明を生成するために使用されます。

      AIプロファイルを作成および構成するには、DBMS_CLOUD_AIを使用したAIプロファイルの構成を参照してください。

  2. 「AIアクセスのチェック」をクリックします。

    AIポリシー・チェッカは、次のサービスをチェックします:

    • 生成AI - Data Studioツールは、生成AIサービスにアクセスできるかどうかをチェックします。
  3. 「AIプロファイルの管理」には、AIプロファイルに関する情報を表示する表形式のデータが表示されます。AIプロファイルに基づいて次のフィールド値が表示されます:
    • プロファイル名
    • プロバイダ
    • 資格証明
    • モデル
    • アクション: AIプロファイルを作成するために構成した任意のフィールドを編集できます。AIプロファイルを削除することもできます。

    「AIプロファイルの管理」に表示される列フィールドの詳細は、「AIプロファイルの作成」を参照してください。

「Data Studio設定」ウィザードの「ベクトル索引」タブで、ベクトル索引を作成できます。

ノート:

「ベクトル索引」タブは、Oracle AI Database 19cでは表示できません。

「ベクトル索引の管理」には、ベクトル索引のリストが表示されます。使用可能なベクトル索引がない場合は、「ベクトル索引の作成」をクリックします。

「ベクトル索引の作成」を選択すると、「ベクトル索引の作成」ウィザードが開きます。
  1. 「必須設定」タブで、作成するベクトル索引を構成するフィールドを表示し、データのロード元となるソースを指定できます:
    • ベクトル索引名: このウィザードを使用して作成するベクトル索引オブジェクトの名前を指定します。この名前は、索引を管理または問い合せる場合にSQLおよびコンソールで使用できます。
    • 場所: ドロップダウン・フィールドから、索引付け対象のソース・データのクラウドの場所を選択します。場所の名前を入力することもできます。これは、ベクトル索引の構築またはリフレッシュ時にデータベースの読取り元となるオブジェクト・ストレージ・バケットなどのクラウド・ストアです。
    • AIプロファイル: 「Data Studio設定」ウィザードの「AIプロファイル」タブから作成したAIプロファイルを選択します。このフィールドでは、「AIプロファイルの作成」ウィザードのAIプロファイル・フィールドにリンクされたベクトル索引を使用します。
    • オブジェクト・ストレージの資格証明名: 指定したオブジェクト・ストレージの場所(OCIユーザー資格証明やリソース・プリンシパルベースの資格証明など)にデータベースが安全にアクセスできるようにする、格納済の資格証明をドロップダウンから選択します。

    「作成」をクリックすると、ベクトル索引を作成し、オプション・フィールドの値をスキップできます。

    「次」をクリックして、次のオプション・フィールドの値を指定します。

    これらのオプション・フィールドは、ベクトル検索時にドキュメントをチャンク化、索引付けおよび取得する方法を制御します。必要に応じて、これらのフィールドに値を入力して、ベクトル索引の構築方法、更新方法および問合せ方法を制御し、ワークロードに有益な結果を返すようにできます。

  2. 「オプション設定」で、次のフィールド値を指定します:
    • チャンク・サイズ: 1つのベクトルとして埋め込まれ、格納される各テキストの文字(または実装に応じてトークン)数を指定します。チャンクを大きくすると文脈を広くとらえることができますが、一節単位での一致精度は低くなる可能性があります。
    • チャンク重複: 連続するチャンク間の重複量を指定して、境界近くのコンテンツが複数のチャンクに出現するようにし、分割点に位置する関連テキストを取りこぼす可能性を低減します。
    • リフレッシュ・レート: ベクトル索引がソース・データから自動的にリフレッシュされる間隔(分単位)を指定し、新規または更新されたコンテンツが再度埋め込まれ、検索できるようにします。
    • ベクトル距離メトリック: 検索時にベクトルを比較するために使用される類似度メトリック(COSINEなど)を指定します。これにより、問合せのベクトルと格納済のベクトル間の"近さ(類似度)"の算出方法が決まります。
    • 一致限度: ベクトル検索が各問合せに対して返す結果の最大数を指定します。
    • 類似度しきい値: ベクトル検索から結果を返すのに必要な最小類似度スコアを指定します。スコアがこのしきい値を下回る結果は、関連性が不十分であるとして除外されます。

    「作成」をクリックしてベクトル索引を作成します。

    ベクトル索引を作成した後、「AIプロファイルの管理」から以前に作成したAIプロファイルを編集したり、ベクトル索引を追加できます。

Data Studioプリファレンス・ウィザードのSMTPでは、システム上のローカル電子メール・クライアント(Thunderbirdなど)などの電子メール・サービスを構成できます。

ノート:

SMTPは1回だけ構成するものであり、それ以降、システムはその時点に保存された構成を使用します。
ウィザードのSMTPタブで、次のフィールド値を指定します:
  1. サーバー・ホスト: 電子メールの送信に使用されるエンドポイントを入力します。たとえば、internal-mailrouter.oracle.comなどです。
  2. サーバー・ポート: 電子メールの受入れに使用するSMTPポートを入力します。電子メール配信はポート25でTLSをサポートしています。送信者:
  3. 送信者の電子メール・アドレスを入力します。たとえば、oaapgens_us@oracle.comなどです。
  4. サーバーの暗号化: このフィールドは、電子メール送信時の暗号化を実行する標準的な方法であるTLSを使用しているかどうかを示します。プロバイダは、Oracle Cloud Infrastructure電子メール配信サービスへの送信中に電子メールを暗号化する必要があります。暗号化された電子メールは転送中に読み取られないよう保護されます。暗号化されていない場合は、「なし」と入力します。
  5. SMTP接続に使用する資格証明をドロップダウンから選択します。使用可能な資格証明がドロップダウンにない場合は、「資格証明の作成」アイコンをクリックして資格証明を作成できます。詳細は、Oracle Cloud Infrastructureネイティブ資格証明の作成を参照してください。

「テスト」をクリックしてSMTP構成をテストします。ACLスクリプトの実行を要求する画面が表示されます。ADMIN権限がある場合は、スクリプトを実行できます。これは、初回の設定です。SMTPテスト完了のメッセージが表示されたら、SMTP構成を保存できます。

「マーケットプレイス」タブでは、データ・マーケットプレイス・ツールに必要な構成を設定できます。

データ・マーケットプレイスのデータへのアクセスは、ユーザー認可に基づいて制限されます。管理者以外のユーザーには、Data Studio設定構成に基づいてデータ・マーケットプレイス・ツールにアクセスする権限があります。次のオプションが表示されます:
  • 制限付き。認可が必要:

    このオプションを選択すると、制限付きクラウド・リンクを公開でき、その結果として制限付きマーケットプレイス・リストも公開できるようになります。これらのリストへのアクセス権を特定のOCIDに付与および取り消すことができます。

  • 公開:

    このオプションは、登録された表へのアクセスを許可されるユーザーおよびその場所を指定します。

    次のいずれかの使用可能なオプションを選択できます。
    • テナンシ: データ・セットを登録しているAutonomous Databaseインスタンスのテナンシ内の任意のリソース、テナンシ、コンパートメントまたはデータベースへのリモート・データ・アクセス権を付与できます。このスコープは、「リージョン」スコープよりも制限されています。
    • コンパートメント: データ・セットを登録しているAutonomous Databaseインスタンスのコンパートメント内の任意のリソース、コンパートメントまたはデータベースへのリモート・データ・アクセス権を付与できます。
    • リージョン: データ・セットを登録しているAutonomous Databaseインスタンス内の他のテナンシへのクラウド・リンクを介して、リモート・データ・アクセス権を付与できます。

      ノート:

      マーケットプレイス・リストは現在、コンパートメント・レベルまでしか公開できません。ツールでは、セキュリティ上の理由から、マーケットプレイス・リストをリージョン全体に公開することはできません。
    • なし: いかなるリソースにもアクセスする権限がありません。
  • 読取り:

    このオプションを使用すると、特定のユーザーが登録された表にアクセスするための読取りアクセスが可能になります。

「Slack」タブでは、「ジョブ」機能の使用中に特定のイベントに関する通知を受信するようにSlackプロファイルを構成できます。

次のフィールド値を指定します。
  • Slack資格証明名: ドロップダウンから資格証明を入力します。ドロップダウンには、コンパートメント内の資格証明がリストされます。独自の資格証明を作成するには、「+」をクリックします。
    • 「+」を選択すると、「資格証明の作成」ダイアログ・ボックスが開きます。資格証明を作成するには、次のフィールド値を指定します:
      • 資格証明名: わかりやすい名前を入力します。たとえば、SLACK_CREDです。
      • クラウド・サービス: ドロップダウンから「Slack」を選択します。
      • ユーザー名: OCIユーザー名を入力します。OCIコンソールのプロファイルからOracle Cloud Infrastructureユーザー名を使用する必要があります。例: oracleidentitycloudservice/foo@example.comまたは

        default/foo@example.com

      • パスワード: *********。スラック・プロバイダの場合、ユーザー名の値は任意の有効な文字列にすることができ、パスワードはSlackボット・トークンです。

        「資格証明の作成」をクリックして、新しい資格証明を作成します。

      「Slack資格証明名」フィールドにこの値を入力します。

  • SlackチャネルID: これは、チャネルIDをString値で指定します。チャネルIDはチャネルの一意のIDであり、チャネル名とは異なります。Slackでは、チャネルの詳細を表示すると、「情報」タブでチャネルIDを確認できます。

  • Slackメッセージ: 通知をテストするメッセージを入力します。

    「テスト」をクリックして通知をテストします。「Data Studio設定」からSlackへの認証に成功すると、確認メッセージが表示されます。「保存」をクリックして、Slack資格証明を設定します。

    「ジョブの作成」を参照すると、ジョブ実行のステータスに関するSlackアラートを受信するための通知を設定できます。

「プロバイダ・アイデンティティの共有」タブで、データを共有する前にプロバイダの詳細を指定できます。共有プロバイダ識別子は、「データ共有」ツールの使用中に共有権限を付与される受信者に提供されます。これにより、ユーザーの識別方法に関する情報が受信者に提供されます。

次のフィールド値を指定します。
  • 名前: プロバイダの名前を入力します。たとえば、amsです。
  • 電子メール: プロバイダの電子メール・アドレスを入力します。たとえば、ams@gmail.comです。
  • 説明: プロバイダの説明を入力します。たとえば、AMS sharing stuffです。

「保存」をクリックして、プロバイダ識別情報を保存します。プロバイダ識別情報の構成が成功したことを示すメッセージが表示されます。

「変更の適用」を選択して、データ設定ダイアログの「マーケットプレイス」タブで行った構成を保存して適用します。

Data Studio設定ウィザードでプリファレンスを正常に設定および構成しました。