1. Oracle EssbaseのREST API
  2. タスク
  3. アプリケーション接続

アプリケーション接続の取得

get

/essbase/rest/v1/applications/{applicationName}/connections/{connectionName}

指定されたアプリケーションレベル接続について詳細を返します。

リクエスト

パス・パラメータ
問合せパラメータ

  • trueに設定した場合は、結果で暗号化パスワードが返されます。

先頭に戻る

レスポンス

サポートされているメディア・タイプ

200 レスポンス

OK

接続の詳細が正常に返されました。

本体()
ルート・スキーマ : connection
型: object
ソースの表示

  • オプション。typeがDBである場合に、汎用JDBCドライバを使用するようにEssbaseを構成するには、JDBCドライバの完全修飾クラス名を指定します。oracle.jdbc.driver.OracleDriverなどです。

  • 外部RDBMSデータベースへのURLまたはEssbaseインスタンスへの検出URL。他のEssbaseインスタンスへの接続の場合、このパラメータはhostおよびportを指定するかわりになります。Essbase検出URLの例: https://192.0.2.1:443/essbase/agent。他の使用方法の例は、グローバルな「接続の取得」エンドポイントのドキュメントを参照してください。

  • この接続の説明文字列。

  • ホスト・サーバー名またはIP。Oracle Database接続の場合、必須です。Essbase接続の場合、かわりにdbURLを使用しないかぎり、必須です。

  • links

  • 最大接続プール・サイズ。デフォルトは50です。接続エラーが発生した場合、最小および最大接続プール・サイズの調整が必要になることがあります。Universal Connection Pool開発者ガイドのUCPでのプール・サイズの制御についてを参照してください。

  • 最小接続プール・サイズ。デフォルトは5です。接続エラーが発生した場合、最小および最大接続プール・サイズの調整が必要になることがあります。Universal Connection Pool開発者ガイドのUCPでのプール・サイズの制御についてを参照してください。

  • この接続の名前。

  • 必須。この接続のリモート・ソースへのアクセスを認可されているユーザーIDのパスワード。

  • ファイル・タイプ接続の場合、必須です。データのファイル・ソースへのカタログ・パス。例: /gallery/Technical/Drill Through/DrillthroughDS.csv

  • リモート・ホストのポート番号。hostが指定されているときの接続の場合、必須です。

  • すでに使用可能なAutonomous Data Warehouse接続(リポジトリ接続)を使用している場合、trueに設定します。その場合、ウォレットをアップロードする必要はありません。

  • Oracle Database接続を定義している場合、サービス名。

  • Oracle Databaseを一意に識別するOracleシステムID (SID)。Oracle Database接続の場合、かわりにserviceを使用しないかぎり、必須です。

  • 指定可能な値: [ "TEMPLATE", "EXCELFILE", "DB", "DELIMITEDFILE", "FIXEDWIDTHFILE", "ESSBASE", "JDBC", "SPARK", "MS_SQL", "MYSQL", "DB2", "ORACLE", "FILE" ]

    外部ソースのタイプ。サポートされているソースおよびバージョンは、動作保証マトリックス(プラットフォームSQL表)の「データベース」セクションを参照してください。

  • 指定可能な値: [ "FILE", "DB", "ESSBASE" ]

    必須。接続のタイプ。サーバー上のファイルに接続する場合はFILE、外部ソース・システムに接続する場合はDB、別のキューブに接続する場合はESSBASE。

  • 必須。この接続のリモート・ソースへのアクセスを認可されているユーザーID。

  • Autonomous Data Warehouseへの接続に必要な場合(repoWallet = falseの場合)、ウォレット・ファイルへのパス。例: /system/wallets/EssbaseADWS。Oracle Cloud InfrastructureでAutonomous Data Warehouseの「管理」ページから「クライアント資格証明(ウォレット)のダウンロード」を選択してウォレット・ファイルを取得します。すでに使用可能な接続(リポジトリ接続)を使用している場合、ウォレットをアップロードする必要はありません。

400 レスポンス

不正なリクエスト

接続詳細の取得に失敗しました。

先頭に戻る

例

次の例では、特定のアプリケーションレベル接続の詳細を取得する方法を示します。

これら例では、cURLを使用して、Windowsシェル・スクリプトからREST APIにアクセスします。呼出し元ユーザーのIDおよびパスワードは変数であり、properties.bat内でその変数値が設定されています。

cURLコマンドを含むスクリプト - Oracle Database接続

次の例では、アプリケーションSampleに定義されているOracle Database接続の詳細を取得します。

call properties.bat
curl -X GET "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/connections/OracleDB" -H Accept:application/json -u %User%:%Password%

レスポンス本体の例

次の例では、レスポンス本体の内容をJSON形式で示します。

{
  "name" : "OracleDB",
  "description" : "Connection to Database",
  "type" : "DB",
  "subtype" : "ORACLE",
  "minPoolSize" : 5,
  "maxPoolSize" : 50,
  "host" : "dbhostname.example.com",
  "port" : 1521,
  "user" : "essbase"
  "sid" : "orcl",
  "links" : [ {
    "rel" : "self",
    "href" : "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/connections/OracleDB",
    "method" : "GET"
  }, {
    "rel" : "edit",
    "href" : "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/connections/OracleDB",
    "method" : "PUT"
  }, {
    "rel" : "delete",
    "href" : "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/connections/OracleDB",
    "method" : "DELETE"
  }, {
    "rel" : "self",
    "href" : "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/connections/OracleDB/actions/test",
    "method" : "POST"
  } ]
}

cURLコマンドを含むスクリプト - Autonomous Data Warehouseへの接続

次の例では、Essbaseがフェデレーテッド・パーティションで動作できるように設定されているAutonomous Data Warehouse on Shared Infrastructureへの接続の詳細を示します。フェデレーテッド・パーティションは、Oracle Cloud Infrastructure上のEssbaseデプロイメントに対してのみサポートされています。

call properties.bat
curl -X GET "https://myserver.example.com:9001/essbase/rest/v1/applications/Sample/connections/FedPart_conn?links=none" -H Accept:application/json -u %User%:%Password%

レスポンス本体の例

次の例では、レスポンス本体の内容をJSON形式で示します。

{
  "name" : "FedPart_conn",
  "description" : "Connection for federated partition to Autonomous Data Warehouse",
  "type" : "DB",
  "subtype" : "ORACLE",
  "walletPath" : "/system/wallets/Sample/FedPart_conn",
  "minPoolSize" : 5,
  "maxPoolSize" : 50,
  "user" : "essbase",
  "service" : "adwsql_low",
  "links" : [ ]
}
先頭に戻る