Data Gateway für Berichte konfigurieren und registrieren

Führen Sie diese optionalen Schritte aus, um Remoteverbindungen für klassische Features wie Analysen und Dashboards zu ermöglichen.

Wenn Sie nur Datenvisualisierungen bereitstellen (z.B. Oracle Analytics Cloud Professional Edition), müssen Sie diese Schritte nicht ausführen.

Führen Sie zunächst die Konfigurationsschritte in Data Gateway für Datenvisualisierungen konfigurieren aus.

Rufen Sie den Rechnernamen und die Portnummer auf dem Rechner ab, auf dem Sie einen Data Gateway-Agent installiert haben.
Bei einem Server-Deployment:
1. Führen Sie den Befehl /<Data Gateway install folder>/domain/bin/status.sh aus.
2. Notieren Sie sich den Rechnernamen in der Befehlsausgabe in der URL unter Data Gateway-Status sowie den Wert von Data Gateway-Jetty-HTTP-Port.
Bei einem persönlichen Deployment:
1. Öffnen Sie die Datei: %localappdata%\Temp\DataGateway\ports.properties.
2. Notieren Sie sich den Rechnernamen und die Portnummer.
Starten Sie den Data Gateway-Agent.
Wenn Sie Ihre Daten modellieren möchten, bevor Sie eine Remoteverbindung zu ihnen herstellen, bearbeiten Sie das semantische Modell mit dem semantischen Modellierer oder mit Model Administration Tool (wenn die Datenbank nicht vom semantischen Modellierer unterstützt wird).
Wenn Sie Model Administration Tool verwenden, laden Sie die Metadaten der Java-Datenquelle.
1. Klicken Sie in Model Administration Tool im Menü Datei auf Öffnen und dann auf In der Cloud. Geben Sie anschließend im Dialogfeld "In der Cloud öffnen" die Details des semantischen Modells an.
2. Klicken Sie im Menü Datei auf Java-Datenquellen laden.
3. Führen Sie im Dialogfeld "Verbindung zu Java-Datenquellenserver herstellen" folgende Schritte aus:
  - Geben Sie im Feld Hostname den Rechnernamen ein, den Sie in Schritt 1 notiert haben. Dabei müssen Sie den vollqualifizierten Hostnamen angeben. Beispiel: Wenn Sie machine in Schritt 1 notiert haben, könnten Sie machine.us.example.com angeben.
  - Geben Sie im Feld Port den Port ein, den Sie in Schritt 1 notiert haben. Beispiel: 51811.
  - Geben Sie in den Feldern Benutzername und Kennwort dummy oder eine beliebige Zeichenfolge ein (diese Zugangsdaten werden nicht validiert, da es sich hierbei um einen öffentlichen Aufruf zum Erkennen der von Data Gateway veröffentlichten Funktionen handelt).
Richten Sie eine physische Datenbankverbindung ein, wenn Sie Model Administration Tool verwenden:
1. Erstellen Sie im physischen Layer eine lokale Verbindung (keine Remoteverbindung) zur Datenquelle mit der standardmäßigen Aufrufschnittstelle für Ihre Datenquelle, und modellieren Sie die Daten nach Bedarf.
2. Wenn Sie die Remoteverbindung zum semantischen Modell herstellen und das Modell in der Cloud veröffentlichen möchten, bearbeiten Sie die erstellte Verbindung.
3. Wählen Sie auf der Registerkarte "Allgemein" im Feld Aufrufschnittstelle die Option JDBC (direkter Treiber) aus, und geben Sie im Feld Verbindungszeichenfolge die JDBC-Zeichenfolge und die Zugangsdaten in der Verbindung des semantischen Modells an. Unter JDBC- und JNDI-Vorlagen und Beispiele weiter unten finden Sie eine Liste der unterstützten JDBC-Zeichenfolgen und -Treiberklassen.
4. Geben Sie auf der Registerkarte "Verschiedenes" im Feld SQL über HTTP verwenden "true" ein und im Feld RDC-Version 2. Geben Sie dann die JDBC-Treiberklasse an.
5. Veröffentlichen Sie das semantische Modell in der Cloud.

Jetzt können Sie das Deployment über eine Remoteverbindung mit einer On-Premise-Datenbank testen.

JDBC- und JNDI-Vorlagen und Beispiele

Wenn Sie Remoteverbindungen für Analysen und Dashboards einrichten, müssen Sie möglicherweise JDBC-Zeichenfolgen und -Treiberklassen sowie JNDI-Verbindungs- und Kontextdetails angeben.

JDBC-Zeichenfolgenmuster und -Treiberklassen

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-Vorlagen für native Treiber

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" />

JNDI-Vorlagen für DD-Treiber

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-Treiber zu Data Gateway hinzufügen

Fügen Sie einen JDBC-Treiber zu Ihrer Data Gateway-Installation hinzu, damit Sie Daten in einer On-Premise-Datenbank modellieren können.

Stellen Sie zunächst sicher, dass Data Gateway und Model Administration Tool auf demselben Windows-Rechner in Ihrer On-Premise-Umgebung installiert sind.

Laden Sie den JDBC-Treiber herunter, den Sie bereitstellen möchten.
Beispiel: Um Daten in einer Snowflake-Datenbank zu modellieren, laden Sie den aktuellen Snowflake-JDBC-Treiber herunter (z.B. in Datei snowflake-jdbc-3.9.0.jar).
Kopieren Sie die heruntergeladene JDBC-JAR-Datei in den Installationsordner von Data Gateway.
- Kopieren Sie bei einem Server-Deployment die JAR-Datei in <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers.
- Kopieren Sie die JAR-Datei bei einem persönlichen Deployment unter Windows in <Data Gateway_extract_path>\thirdpartyDrivers.
- Kopieren Sie die JAR-Datei bei einem persönlichen Deployment unter MacOS in <Application->Show Package Contents>Resources->app.nw-> thirdpartyDrivers.
Starten Sie Data Gateway neu. Siehe Data Gateway verwalten.

DSN-Formate zum Angeben von Datenquellen

In Oracle Analytics können Sie On-Premise-Daten für viele Datenbanktypen modellieren. Oracle Analytics unterstützt direkten Zugriff auf einige On-Premise-Datenquellen über das semantische Modell. Wenn Sie die Datenbankverbindung mit Model Administration Tool erstellen, verwenden Sie im Dialogfeld "Verbindungspool" (Registerkarte "Allgemein") im Feld Datenquellenname das jeweilige DSN-Format für den gewünschten Datenbanktyp.

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"]