10 Computeへの接続

この項では、AIデータ・プラットフォーム・ワークベンチのコンピュートを他のビジネス・インテリジェンス・ツールに接続する方法について説明します。

トピック:

接続

AI Data Platform Workbenchは、Oracle Analytics Cloudまたはその他のビジネス・インテリジェンス・ツールと接続できます。

AIデータ・プラットフォーム・ワークベンチが提供するカスタムJDBCまたはODBCを使用して、様々なビジネス・インテリジェンス・ツールからOracle AI Data Platform Workbenchに接続できます。AI Data Platform Workbenchは、サードパーティの商用BIツール(Tableau、Power BI)やDBeaverなどのオープンソースBIツールからの接続もサポートしています。これらのツールから接続するには、AIデータ・プラットフォーム・ワークベンチでコンピュート・クラスタの接続詳細が必要です。この詳細は、「接続の詳細」タブにあります。必要な情報は、接続元の製品によって異なります。


Dev_cluster_1コンピュート・クラスタの「接続の詳細」タブ

Oracle AnalyticsをOracle AI Data Platform Workbenchに接続

Oracle Analytics Cloudインスタンスから、AIデータ・プラットフォーム・ワークベンチ・インスタンスによって管理されるカタログまたは表に接続できます。

Oracle AnalyticsからAIデータ・プラットフォーム・ワークベンチへの接続を作成するには、AIデータ・プラットフォームからの接続ファイルとOracle Analytics CloudからのAPIキーが必要です。

Oracle Analytics接続構成ファイルの取得

config.jsonファイルをOracle AI Data Platform Workbenchインスタンスからダウンロードして、Oracle Analyticsに接続する必要があります。

少なくとも2 OCPUのコンピュート・クラスタ、ドライバ・ノードとワーカー・ノードの両方に32 GBのメモリー、および少なくとも2つのワーカーが必要です。
  1. ワークスペースに移動し、「コンピュート」をクリックします。

    Cluster_Highコンピュート・クラスタが強調表示されたコンピュート・ページが開いています

  2. Oracle Analyticsに接続するクラスタをクリックします。
  3. 「接続の詳細」タブで、Oracle Analytics Cloudロゴの下にある「ダウンロード」アイコンをクリックします。config.jsonファイルがマシンにダウンロードされます。

    Cluster_Highクラスタのコンピュート・ページが開き、「接続の詳細」タブとOracle Analytics Cloudのダウンロードが強調表示されています

Oracle Analyticsへの接続

Oracle Analyticsインスタンスから、AIデータ・プラットフォーム・ワークベンチ・インスタンスによって管理されるカタログまたは表に接続できます。

Oracle Analyticsで接続を作成する前に、AIデータ・プラットフォームの接続構成ファイルがあることを確認してください。Oracle Analytics接続構成ファイルの取得を参照してください。
AIデータ・プラットフォーム・ワークベンチ・インスタンスへのOracle Analytics接続では、接続ごとに1つのカタログのみがサポートされます。複数のカタログを使用するには、追加の接続を作成する必要があります。
  1. Oracle Analyticsのホーム・ページで、「作成」をクリックしてから、「接続」をクリックします。
  2. 「Oracle AI Data Platform」をクリックします。
  3. 接続の名前と説明を入力します。
  4. 「場所」で、接続の保存先を指定します。他のユーザーと接続を共有するには、/共有フォルダに保存します。
  5. Oracle Analytics Cloudの「接続の詳細」で、「選択」をクリックし、config.jsonファイルに移動して「開く」をクリックします。
  6. 認証タイプとして「APIキー」を選択します。
  7. 「公開APIキー」で、「生成」、「コピー」の順にクリックします。
  8. OCIで、APIキーを追加します。
    1. OCIで、ユーザー・アイコンをクリックし、「ユーザー設定」をクリックします。
    2. マイ・プロファイルで、「トークンとキー」をクリックし、「APIキーの追加」をクリックします。
    3. 「Paste a public key」を選択し、ステップ7で生成したキーをコピーして、「Add」をクリックします。
    APIキーが同期するまで2分から3分待ちます。
  9. 「カタログ」で、データセットで使用するカタログ名を指定します。
    「カタログ」リストがロードされず、「ユーザーには操作を実行するための十分な権限がありません」というアラート・メッセージが表示される場合は、APIキーが同期するまで少し待ちます。
  10. 「保存」をクリックします
  11. データセットを作成して、新しい接続をテストします。

手順に従い、接続の保存またはスキーマのリストに問題がある場合、クラスタの再起動が必要になる場合があります。

JDBCドライバのダウンロード

JDBCドライバは、「接続の詳細」タブからダウンロードして、様々なBIツール用に構成できます。

  1. ワークスペースに移動し、「コンピュート」をクリックします。
  2. JDBC互換BIツールに接続するクラスタをクリックし、「接続」をクリックします。
  3. 「JDBCドライバのダウンロード」をクリックします。

DBeaverの構成

AI Data Platform Workbenchのコンピュート・クラスタに接続する前に、DBeaverをインストールし、Oracle AI Data Platform Workbenchからダウンロードしたファイルを準備する必要があります。

  1. DBeaverクライアントをダウンロードしてインストールします。CommunityまたはEnterpriseのいずれかのバージョンを使用できますが、少なくとも22.x.DBeaverは、Windows、Mac OS X、EclipseプラグインおよびLinuxでのみ使用可能です。
  2. 「JDBCドライバのダウンロード」からファイルを解凍します。
  3. 解凍されたファイルから、simbaSpark.zipドライバ・ファイルを解凍します。

Spark Simba JDBCドライバを使用したDBeaverの構成

DBeaverを構成して、Oracle AI Data Platform Workbenchのコンピュート・クラスタに接続できます。

DBeaverをインストールし、AI Data Platform WorkbenchからダウンロードしたsimbaSpark.zipファイルを抽出しておく必要があります。
  1. DBeaverを開きます。
  2. 「データベース・ナビゲータ」をクリックします。
  3. 「ドライバ・マネージャ」をクリックします。
  4. 「新規」をクリックします。
  5. 「ドライバ名」として「AIデータ・プラットフォーム」を入力します。
  6. 「ライブラリ」をクリックします。
  7. 「フォルダの追加」をクリックします。
  8. sparkSimba.zip抽出の場所を参照します。
  9. 「クラスの検索」をクリックします。
  10. Select 「OK」を選択します。
  11. ドライバ・クラスをcom.simba.spark.jdbc.Driverに設定します。
  12. 「設定」をクリックします。
  13. 「クラス名」をcom.simba.spark.jdbc.Driverに設定します。
  14. 「OK」をクリックします。

DBeaverでのデータベース接続の作成

Oracle AI Data Platform WorkbenchでDBeaverをコンピュート・クラスタに接続するには、まずDBeaverでデータベース接続を作成する必要があります。

AI Data Platform WorkbenchからダウンロードしたSpark Simba JDBCドライバを使用してDBeaverを構成しておく必要があります。詳細は、Spark Simba JDBCドライバを使用したDBeaverの構成を参照してください。
  1. DBeaverを開きます。
  2. 「データベース」をクリックします。
  3. 「新規データベース接続」をクリックします。
  4. 「すべて」をクリックします。
  5. 「AI Data Platform」を選択します。
  6. 「次へ」をクリックしてください。
  7. JDBCドライバーのURLを入力します。JDBC URLは、AIデータ・プラットフォーム・ワークベンチの計算クラスタの「接続の詳細」タブにあります。
  8. 「終了」をクリックします。

JDBCを使用したDBeaverからOracle AI Data Platform Workbenchへの接続

DBeaverが構成され、AI Data Platform Workbenchへのデータベース接続が確立されると、DBeaverとAI Data Platform Workbenchの間の接続を完了できます。

  1. DBeaverを開きます。
  2. 「接続」をクリックします。
  3. 認可トークンまたはAPIキーで接続することを選択します。
    • 認可トークンを使用して接続
      • DEFAULTプロファイルがない場合は、URLにプロファイルを指定せずにトークンを使用します。例: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5

        URLによってブラウザ・ウィンドウが開きます。

        AI Data Platform Workbenchインスタンスが作成されているテナンシにサインインします。

        詳細は、CLI用のトークンベースの認証を参照してください。

    • APIキーを使用して接続します。接続URLにociProfile=<profile_name>を指定してOCIプロファイルを指定します。

      • APIキー認証を使用して、AI Data Platform Workbenchインスタンスに接続します。

        接続URLにociProfile=<profile_name>を指定してOCIプロファイルを指定することで、APIキーを使用します。たとえば、OCIプロファイル名デモを使用するには: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5 ;ociProfile=Demo

        詳細は、必要なキーとOCIDを参照してください。

  4. DBeaverは、メタデータを読み取るための接続と、他のすべての操作のための接続を作成します。接続に制限がある場合は、2番目の接続を無効にして、DBeaverがすべての操作に1つの接続を使用するようにできます。
    1. 「プリファレンス」をクリックします。
    2. 「共通」をクリックします。
    3. 「メタデータ」をクリックします。
    4. 「メタデータ読取り用に個別の接続を開く」の選択を解除します。

ODBCドライバのダウンロード

ODBCドライバは、「接続の詳細」タブからダウンロードし、様々なBIツール用に構成できます。

  1. ワークスペースに移動し、「コンピュート」をクリックします。
  2. ODBC互換BIツールに接続するクラスタをクリックし、「接続」をクリックします。
  3. 「ODBCドライバのダウンロード」をクリックします。
  4. リストから適切なOSを選択します。

    「ODBC Driver OS」ドロップダウンが開き、Mac、WindowsおよびLinxオプションが表示されています