レポート用のデータ・ゲートウェイの構成と登録

機械翻訳について

レポート用のデータ・ゲートウェイの構成と登録

分析およびダッシュボードなどのクラシック機能のリモート接続を有効化する場合、次のオプション・ステップを実行します。

データ・ビジュアライゼーションのみをデプロイする場合(たとえば、Oracle Analytics Cloud Professional Edition)、これらのステップに従う必要はありません。

開始する前に、「データ・ビジュアライゼーションのためのデータ・ゲートウェイの構成」の構成ステップに従います。

データ・ゲートウェイ・エージェントをインストールしたマシンで、マシン名とポート番号を取得します。
サーバーのデプロイメントで:
1. /<Data Gateway install folder>/domain/bin/status.shコマンドを実行します。
2. コマンド出力で、「データ・ゲートウェイ・ステータス」の下に表示されているURL内に含まれているマシン名をノートし、「データ・ゲートウェイのJetty HTTPポート」の値を書きとめます。
個人デプロイメントの場合:
1. ファイルを開く: %localappdata%\Temp\DataGateway\ports.properties。
2. マシン名とポート番号をノートします。
データ・ゲートウェイ・エージェントを起動します。
データへのリモート接続を開始する前にそのデータをモデル化する場合は、セマンティック・モデラーまたはモデル管理ツール(データベースがセマンティック・モデラーによってサポートされていない場合)を使用して、セマンティック・モデルを編集します。
モデル管理ツールを使用している場合は、Javaデータ・ソース・メタデータをロードします。
1. モデル管理ツールで、「ファイル」メニューから「オープン」、「クラウドの中で」の順にクリックし、クラウドで開くダイアログを使用してセマンティック・モデルの詳細を指定します。
2. 「ファイル」メニューから、「Javaデータ・ソースのロード」をクリックします。
3. Javaデータソース・サーバーに接続ダイアログで、次のようにします:
  - 「ホスト名」フィールドに、ステップ1でノートしたマシン名を入力します。ホスト名を完全修飾します。たとえば、ステップ1でmachineをノートした場合、machine.us.example.comを指定できます。
  - 「ポート」フィールドに、ステップ1で書き留めたポートを入力します。たとえば、51811です。
  - 「ユーザー名」フィールドおよび「パスワード」フィールドには、dummyまたは任意の文字列を入力します(これらの資格証明は、データ・ゲートウェイによって通知された機能を検出するパブリック・コールであるため、検証されません)。
モデル管理ツールを使用している場合は、物理データベース接続を設定します:
1. 物理レイヤーで、データ・ソースに適切な標準コール・インタフェースを使用して、データ・ソースへの(リモートではなく)ローカル接続を作成し、必要に応じてデータをモデル化します。
2. セマンティック・モデルへのリモート接続を作成してクラウドに公開する準備ができたら、作成した接続を編集します。
3. 「一般」タブの「コール・インタフェース」フィールドでJDBC (Direct Driver)を選択し、「接続文字列」フィールドでセマンティック・モデル接続でJDBC文字列および資格証明を指定します。サポートされるJDBC文字列とドライバ・クラスのリストは、「JDBCおよびJNDIテンプレートと例」を参照してください。
4. 「その他」タブの「HTTP経由のSQLの使用」フィールドにtrueを入力し、「RDCバージョン」フィールドに2と入力してJDBCドライバ・クラスを指定します。
5. クラウドにセマンティック・モデルを公開します。

これで、オンプレミス・データベースにリモート接続してデプロイメントをテストする準備ができました。

JDBCおよびJNDIテンプレートと例

分析とダッシュボードにリモート接続を設定する際、JDBC文字列とドライバ・クラス、JNDI接続の詳細とコンテキストの詳細を指定する必要がある場合があります。

JDBC文字列パターンとドライバ・クラス

Oracle:
   Driver Class: oracle.jdbc.OracleDriver
   jdbc string: jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=[\"host-name\"])(PORT=[\"port\"]))(CONNECT_DATA=(SERVICE_NAME=[\"service-name\"])))              
Amazon Redshift:
   Driver Class: com.oracle.jdbc.redshift.RedshiftDriver 
   JDBC String: jdbc:oracle:redshift://[\"host-name\"]:[\"port\"];DatabaseName=[\"service-name\"];EncryptionMethod=SSL;ValidateServerCertificate=false
Apache Hive
    Driver Class: com.oracle.bi.jdbc.hive.HiveDriver
    JDBC String: jdbc:oracle:hive://[\"host-name\"]:[\"port\"];EncryptionMethod=SSL;ValidateServerCertificate=false
DB2
   Driver Class: com.oracle.bi.jdbc.db2.DB2Driver
   JDBC String: jdbc:oracle:db2://[\"host-name\"]:[\"port\"];DatabaseName=[\"service-name\"]
Impala
   Driver Class: com.oracle.bi.jdbc.impala.ImpalaDriver
   JDBC String: jdbc:oracle:impala://[\"host-name\"]:[\"port\"];EncryptionMethod=SSL;ValidateServerCertificate=false
MySQL
   Driver Class: com.mysql.cj.jdbc.Driver
   JDBC String: jdbc:mysql://[\"host-name\"]:[\"port\"]"[/database][?properties]
SQL Server
   Driver Class: com.oracle.bi.jdbc.sqlserver.SQLServerDriver
   JDBC String: jdbc:oracle:sqlserver://[\"host-name\"]:[\"port\"];DatabaseName=[\"service-name\"]
Teradata
   Driver Class: com.teradata.jdbc.TeraDriver
   JDBC String: jdbc:teradata://[\"host-name\"]/DBS_PORT=[\"port\"]

ネイティブ・ドライバのJNDIテンプレート

Oracle:
      <Resource               
      name="jdbc/myoracle"               
      global="jdbc/myoracle"               
      auth="Container"               
      type="javax.sql.DataSource"               
      driverClassName="oracle.jdbc.OracleDriver"                
      url="jdbc:oracle:thin:@localhost:1521:orcl"               
      username="my_user"               
      password="my_password"               
      maxActive="15"               
      maxIdle="1"                
      maxWait="-1"
      />

      <Resource               
      name="jdbc/oracleolap"               
      global="jdbc/oracleolap"               
      auth="Container"               
      type="javax.sql.DataSource"               
      driverClassName="oracle.jdbc.OracleDriver"                
      url="jdbc:oracle:thin:@localhost:1522:orcl112"               
      username="my_user"               
      password="my_password"          
      maxActive="15"               
      maxIdle="1"                
      maxWait="-1"
      />

      <Resource               
      name="jdbc/oraclenorthwind"               
      global="jdbc/oraclenorthwind"               
      auth="Container"               
      type="javax.sql.DataSource"               
      driverClassName="oracle.jdbc.OracleDriver"                
      url="jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=example.com)(PORT=1234))(CONNECT_DATA=(SERVICE_NAME=MATSDB.EXMAPLE.COM)))"               
      username="my_user"               
      password="my_password"          
      maxActive="15"               
      maxIdle="1"                
      maxWait="-1"
      />

      DB2
      <Resource               
      name="jdbc/db2northdb"               
      global="jdbc/db2northdb"               
      auth="Container"               
      type="javax.sql.DataSource"               
      driverClassName="com.ibm.db2.jcc.DB2Driver"                
      url="jdbc:db2://example.com:58263/NORTHDB"               
      username="my_user"               
      password="my_password"              
      maxActive="15"               
      maxIdle="1"                 
      maxWait="-1" />

      SQLServer: 
      <Resource               
      name="jdbc/sqlservernorthwind"               
      global="jdbc/sqlservernorthwind"               
      auth="Container"               
      type="javax.sql.DataSource"               
      driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"               
      url="jdbc:sqlserver://example.com:61045;DatabaseName=Northwind"               
      username="my_user"               
      password="my_password"           
      maxActive="15"               
      maxIdle="1"                
      maxWait="-1" /> 

      Teradata:
      <Resource               
      name="jdbc/teranorthwind"               
      global="jdbc/teranorthwind"               
      auth="Container"               
      type="javax.sql.DataSource"               
      driverClassName="com.teradata.jdbc.TeraDriver"                
      url="jdbc:teradata://99.999.99.999"               
      username="my_user"               
      password="my_password"           
      maxActive="15"               
      maxIdle="1"                
      maxWait="-1" />

      Mysql_community
      <Resource        
      name="jdbc/CEmysql"        
      auth="Container"        
      type="com.mysql.jdbc.jdbc2.optional.MysqlDataSource"        
      factory="com.mysql.jdbc.jdbc2.optional.MysqlDataSourceFactory"        
      username="my_user"               
      password="my_password"    
      serverName="example.com"        
      portNumber="3306"        
      databaseName="my_database" />

DDドライバのJNDIテンプレート

The JNDI for DD Drivers.
SQLServer:
<Resource
name="jdbc/DDsqlserver"
auth="Container"
type="com.oracle.bi.jdbcx.sqlserver.SQLServerDataSource"
factory="com.oracle.bi.jdbcx.sqlserver.SQLServerDataSourceFactory"
user="my_user"
password="my_password"
serverName="example.com\MSSQLSERVER16"
portNumber="61045"
databaseName="my_database" />

DB2:
<Resource
name="jdbc/DDdb2"
auth="Container"
type="com.oracle.bi.jdbcx.db2.DB2DataSource"
factory="com.oracle.bi.jdbcx.db2.DB2DataSourceFactory"
user="my_user"
password="my_password"
serverName="example.com"
portNumber="58263"
databaseName="my_database"
/> 

Impala:
<Resource
name="jdbc/DDimpala"
auth="Container"
type="com.oracle.bi.jdbcx.impala.ImpalaDataSource"
factory="com.oracle.bi.jdbcx.impala.ImpalaDataSourceFactory"
user="my_user"
password="my_password"
serverName="example.com"
portNumber="21050"
databaseName="my_database"
/>

Spark:
<Resource
name="jdbc/DDspark"
auth="Container"
type="com.oracle.bi.jdbcx.sparksql.SparkSQLDataSource"
factory="com.oracle.bi.jdbcx.sparksql.SparkSQLDataSourceFactory"
user="my_user"
password="my_password"
serverName="example.com"
portNumber="10000"
databaseName="my_database"
/>

HIVE:
<Resource
name="jdbc/DDhive"
auth="Container"
type="com.oracle.bi.jdbcx.hive.HiveDataSource"
factory="com.oracle.bi.jdbcx.hive.HiveDataSourceFactory"
user="my_user"
password="my_password"
serverName="example.com"
portNumber="10000"
databaseName="my_database"
/> 

MySQL:
<Resource
name="jdbc/DDmysql"
auth="Container"
type="com.oracle.bi.jdbcx.mysql.MySQLDataSource"
factory="com.oracle.bi.jdbcx.mysql.MySQLDataSourceFactory"
user="my_user"
password="my_password"
serverName="example.com"
portNumber="3306"
databaseName="my_database"
/>

MYSQL:
<Resource
name="jdbc/DDmysql"
auth="Container"
type="com.oracle.bi.jdbcx.mysql.MySQLDataSource"
factory="com.oracle.bi.jdbcx.mysql.MySQLDataSourceFactory"
user="my_user"
password="my_password"
serverName="example.com"
portNumber="3306"
databaseName="my_database" 
/>

データ・ゲートウェイへのJDBCドライバの追加

オンプレミス・データベースでデータをモデリングできるように、データ・ゲートウェイ・インストールにJDBCドライバを追加します。

開始する前に、オンプレミス環境の同一のWindowsコンピュータにデータ・ゲートウェイとモデル管理ツールがインストールされていることを確認します。

デプロイするJDBCドライバをダウンロードします。
たとえば、Snowflakeデータベース内のデータをモデル化するには、最新のSnowflake JDBCドライバをダウンロードします(たとえば、ファイルsnowflake-jdbc-3.9.0.jar)。
ダウンロードしたJDBC JARファイルをデータ・ゲートウェイのインストール・フォルダにコピーします。
- サーバー・デプロイメントで、JARファイルを次の場所にコピー: <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers。
- Windowsでの個別デプロイメントで、JARファイルを次の場所にコピー: <Data Gateway_extract_path>\thirdpartyDrivers。
- MacOSのパーソナライズ・デプロイメントで、JARファイルを次の場所にコピー: <Application->Show Package Contents>Resources->app.nw-> thirdpartyDrivers。
データ・ゲートウェイを再起動します。データ・ゲートウェイのメンテナンスを参照してください。

データソースを指定するためのDSN形式

Oracle Analyticsでは、多くのデータベース・タイプのオンプレミス・データをモデル化できます。 Oracle Analyticsは、セマンティック・モデルを介して一部のオンプレミス・データ・ソースへの直接アクセスをサポートします。モデル管理ツールを使用してデータベース接続を作成するときに、「接続プール」ダイアログ(「一般」タブ)の「データ・ソース名」フィールドで、接続先のデータベース・タイプに適したDSN形式を使用します。

Amazon Redshift:
       DRIVER=Oracle 7.1 Amazon Redshift Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
      SSL: DRIVER=Oracle 7.1 Amazon Redshift Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"];EM=6;CPV=TLSv1.2,TLSv1.1,TLSv1, SSLv3, SSLv2;VSC=0
Apache Drill:
       DRIVER=MapR Drill ODBC Driver;Host=["host-name"];Port=["port"];CastAnyToVarchar=true;ExcludedSchemas=sys,INFORMATION_SCHEMA;AuthenticationType=Basic               Authentication;ConnectionType=Direct
Aster:
       DRIVER=Aster ODBC Driver;SERVER=["host-name"];PORT=["port"];DATABASE=["service-name"]
DB2:
      DRIVER=Oracle 7.1 DB2 Wire Protocol;IpAddress=["host-name"];PORT=["port"];DB=["service-name"]
      SSL:  DRIVER=Oracle 7.1 DB2 Wire Protocol;IpAddress=["host-name"];PORT=["port"];DB=["service-name"];EM=1;VSC=0
Greenplum:
       DRIVER=Oracle 7.1 Greenplum Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
Hive:
       DRIVER=Oracle 8.0 Apache Hive Wire Protocol;HOST=["host-name"];PORT=["port"]
      SSL: DRIVER=Oracle 8.0 Apache Hive Wire Protocol;HOST=["host-name"];PORT=["port"];EM=1;VSC=0
Impala:
       DRIVER=Oracle 7.1 Impala Wire Protocol;HOST=["host-name"];PORT=["port"]
     SSL:  DRIVER=Oracle 7.1 Impala Wire Protocol;HOST=["host-name"];PORT=["port"];EM=1;VSC=0
Informix:
       DRIVER=Oracle 7.1 Informix Wire Protocol;HOSTNAME=["host-name"];PORTNUMBER=["port"];DATABASE=["service-name"]
MongoDB:
       DRIVER=Oracle 8.0 MongoDB;HOST=["host-name"];PORT=["port"];DB=["service-name"]
MySQL:
      DRIVER=Oracle 7.1 MySQL Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
PostgresSql:
       DRIVER=Oracle 7.1 PostgreSQL Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
Spark:
      DRIVER=Oracle 8.0 Apache Spark SQL;HOST=["host-name"];PORT=["port"]
      SSL:  DRIVER=Oracle 8.0 Apache Spark SQL;HOST=["host-name"];PORT=["port"];EM=1;VSC=0
SQL Server:
     DRIVER=Oracle 7.1 SQL Server Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
     SSL:  DRIVER=Oracle 7.1 SQL Server Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"];EM=1;VSC=0;CryptoProtocolVersion=TLSv1.2,TLSv1.1,TLSv1,SSLv3,SSLv2
Sybase:
       DRIVER=Oracle 7.1 Sybase Wire Protocol;NA=["host-name"], ["port"];DB=["service-name"]
Teradata:
       DRIVER=Oracle 7.1 Teradata;DBCName=["host-name"];port_name=["port"]