データ・ビジュアライゼーション用のデータ・ゲートウェイの構成

データ・ゲートウェイをインストールした後、オンプレミス環境を構成し、ビジュアライゼーション・ワークブックからのリモート接続のために1つ以上のデータ・ゲートウェイ・エージェントを登録します。

1. Oracle Analytics Cloudに管理者としてログインします。
2. Oracle Analytics CloudのURLをコピーします。
   1. ブラウザで、Oracle Analytics Cloudインスタンスのホーム・ページに移動します。

      エンド・ユーザーがOracle Analytics Cloudへの接続に使用するのと同じURLを使用します。

   2. ブラウザのアドレス・バーで、<ドメイン>までのURLをコピーします(それより後のテキストは不要です)。
      たとえば、URLがhttps://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/uiの場合は、https://oacinst-tenancy.analytics.ocp.oraclecloud.comをコピーします。
      エージェント構成でデータ・ゲートウェイを設定する際に、ステップ4でこのURLを使用します。
3. コンソールでデータ・ゲートウェイを有効化します。このステップには、Oracle Analytics Cloudでの管理者権限が必要です。
   1. Oracle Analytics Cloudに管理者権限でログインします。
   2. Oracle Analytics Cloudホーム・ページで、「コンソール」をクリックします。
   3. 「リモート・データ接続」をクリックします。
   4. 「データ・ゲートウェイの有効化」オプションを有効化します。
      次のステップを完了するため、このブラウザ・ページは開いたままにします。
4. データ・ゲートウェイのインストール マシンで、Jettyサーバーを起動します(まだ起動していない場合)。
   たとえば、インストールの最後に、「インストール完了」ページの「次のステップ」の下にあるJettyの起動をクリックしていないか、インストール後にマシンを再起動した可能性があります。データ・ゲートウェイ・エージェントの起動および停止を参照してください。
5. データ・ゲートウェイ・エージェントごとに、データ・ゲートウェイ・エージェント・ホーム・ページを使用してそのマシンの認可キーを生成します:
   ログインを求められたら、データ・ゲートウェイ・インストーラの「資格証明」ページで指定したものと同じユーザー名とパスワードを入力します。
   1. データ・ゲートウェイ・エージェントを起動するには、Webブラウザを開いて、<Local hostname>:<port>/obiee/config.jspというURLを入力し、データ・ゲートウェイ・エージェント・ホーム・ページを表示します。
      たとえば、Windowsでは、URL http://localhost:8080/obiee/config.jspを入力できます。
      
      .pngの説明
   2. 「URL」フィールドに、ステップ2でコピーしたOracle Analytics CloudのURLを入力します。
   3. 「キーの生成」をクリックしてから、「クリップボードにコピー」をクリックします。
      その他のフィールドは空白のままにします。

      注:

      「テスト」、「保存」および「有効化」はまだクリックしないでください。
6. Oracle Analytics Cloudの「コンソール」ページの「リモート・データ接続」が表示されているブラウザ・セッションに切り替え、デプロイした各データ・ゲートウェイ・エージェントの詳細を追加します。
   1. 「データ・ゲートウェイ」で、「追加」をクリックします。
   2. 「公開キー」に、ステップ4.cの「クリップボードにコピー」オプションを使用してコピーしたキーを貼り付けます。
      キーを貼り付けると、「名前」、「ID」および「ホスト」フィールドに、データ・ゲートウェイをインストールしたオンプレミス・マシンの詳細が入力されます。
   3. 「OK」をクリックして詳細を保存します。
7. データ・ゲートウェイ・エージェント・ホーム・ページに切り替えます。
8. オプション: 必要に応じて、許可されたホスト・フィールドを使用して、特定のホスト・マシンへのデータ・ゲートウェイ・アクセスを制限します。フィールドを空白のままにすると、データ・ゲートウェイは、任意のホスト・マシンにアクセスできるようになります。
   アスタリスク(*)のワイルドカードを使用して、ホスト名とIPアドレスをセミコロンで区切って指定できます。
   たとえば、abcd*.example.com; 10.174.*のようになります。
   デフォルトで、データ・ゲートウェイ・エージェントは、Oracle Analytics Cloudのリモート接続で指定された任意のホストにあるデータ・ソースに接続しようと試みます。「認可済ホスト」フィールドによって、データ・ゲートウェイの接続先となるターゲット・ホストおよびIPアドレスを制約できます。ただし、すべてのエージェントがすべてのリモート問合せを処理できるようにデータ・ゲートウェイを構成する必要があります。
9. オプション: 必要に応じて、許可されたSQL文フィールドを使用して、データ・ゲートウェイを特定のSQLまたはデータ操作言語(DML)の構成要素に制限します。フィールドを空白のままにすると、データ・ゲートウェイは、データ・ソース上で任意のSQL文またはDML構成要素を実行できるようになります。
   たとえば、SELECTと指定すると、データ・ゲートウェイは、リモート・データ・ソースへの読取り専用アクセスに制限されます。または、SELECT; ALTER SESSIONと指定すると、データ・ゲートウェイは、SELECTおよびALTER SESSION操作を使用するように制限されます。
   セマンティック・モデル接続スクリプト(またはどこか他の場所)内のSQLの末尾に空白および制御文字(EOL - 行の終わりまたはCR - 改行)が含まれていないことを確認します。
10. 「テスト」、「保存」、「有効化」の順にクリックします。
    複数のデータ・ゲートウェイ・エージェントをデプロイするには、エージェントごとにステップ4から9を繰り返します。

    テストが失敗するのは、データ・ゲートウェイ・エージェントを認証できないということです。次のような理由が考えられます:

    • エージェント・キーが、Oracle Analytics Cloud Consoleの「リモート・データ接続」ページにコピーされていない。
    • エージェントにエージェント・キーが再生成されたが、新しいキーが、Oracle Analytics Cloud Consoleの「リモート・データ接続」ページにコピーされていない。
    • エージェントからOracle Analytics Cloudへの適切なネットワーク・ルートがない。