Data Gateway configureren en registreren voor rapportage

Voer de volgende optionele stappen uit om externe verbinding met klassieke functies zoals analysen en dashboards te activeren.

Als u alleen gegevensvisualisatie implementeert (bijvoorbeeld Oracle Analytics Cloud Professional Edition), dan hoeft u deze stappen niet te volgen.

Volg, voordat u begint, de configuratiestappen in Data Gateway configureren voor gegevensvisualisatie.

Haal op de computer waarop u een Data Gateway agent hebt geïnstalleerd, de computernaam en het poortnummer op.
In een serverimplementatie:
1. Voer de opdracht /<Installatiemap Data Gateway>/domain/bin/status.sh uit.
2. Zoek in de uitvoer van de opdracht de computernaam in de URL onder Status Data Gateway en noteer deze naam. Noteer ook de waarde voor HTTP-poort Data Gateway Jetty.
In een persoonlijke implementatie:
1. Open het bestand %localappdata%\Temp\DataGateway\ports.properties.
2. Noteer de computernaam en het poortnummer.
Start de Data Gateway agent.
Als u uw gegevens wilt modelleren voordat u op afstand verbinding hiermee maakt, gebruikt u Semantic Modeler of Model Administration Tool (als de database niet wordt ondersteund door Semantic Modeler) om uw semantische model te bewerken.
Als u Model Administration Tool gebruikt, laadt u de metagegevens van de Java-gegevensbron.
1. Klik in Model Administration Tool in het menu Bestand achtereenvolgens op Openen en In de cloud. Geef in het dialoogvenster 'Openen in de cloud' de details voor uw semantische model op.
2. Klik in het menu Bestand op Java-gegevensbronnen laden.
3. Ga als volgt te werk in het dialoogvenster Verbinding maken met Java-gegevensbronserver:
  - Voer in het veld Hostnaam de computernaam in die u in stap 1 hebt genoteerd. Zet de hostnaam om in een volledig gekwalificeerde naam. Bijvoorbeeld: als u in stap 1 computer hebt genoteerd, voert u computer.us.voorbeeld.com in.
  - Voer in het veld Poort de poort in die u in stap 1 hebt genoteerd. Bijvoorbeeld: 51811.
  - Voer in de velden Gebruikersnaam en Wachtwoord de waarde dummy of een andere string in (deze referenties worden niet gevalideerd omdat het een openbare aanroep betreft voor het achterhalen van de functies van Data Gateway).
Als u Model Administration Tool gebruikt, brengt u een fysieke databaseverbinding tot stand:
1. Breng in de fysieke laag een lokale (geen externe) verbinding met uw gegevensbron tot stand met behulp van de standaardaanroepinterface die geschikt is voor uw gegevensbron en modelleer de gegevens naar behoefte.
2. Wanneer u er klaar voor bent een externe verbinding te maken met uw semantische model en het model terug wilt publiceren naar de cloud, moet u de gemaakte verbinding bewerken.
3. Selecteer op het tabblad Algemeen de optie ' JDBC' (directe driver) in het veld Aanroepinterface. In het veld Verbindingsstring geeft u de JDBC-string en de referenties op in de verbinding met het semantische model. Zie JDBC- en JNDI-sjablonen en voorbeelden hiervan hieronder voor een lijst met ondersteunde JDBC-strings en -driverklassen.
4. Voer op het tabblad Overige in het veld SQL via HTTP gebruiken 'waar' in. Voer vervolgens in het veld RDC-versie de waarde 2 in en geef de JDBC-driverklasse op.
5. Publiceer het semantische model in de cloud.

U kunt de implementatie nu testen door extern verbinding te maken met een lokale database.

JDBC- en JNDI-sjablonen en voorbeelden

Wanneer u externe verbindingen instelt voor analysen en dashboards, moet u mogelijk JDBC-strings en -driverklassen en JNDI-verbindingsdetails en -contextdetails specificeren.

JDBC-stringpatronen en -driverklassen

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-sjablonen voor native drivers

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-sjablonen voor DD-drivers

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

Een JDBC-driver toevoegen aan Data Gateway

Voeg een JDBC-driver aan de Data Gateway installatie toe, zodat u gegevens in een lokale database kunt modelleren.

Voordat u begint, moet u controleren of Data Gateway en Model Administration Tool op dezelfde Windows-computer in uw lokale omgeving zijn geïnstalleerd.

Download de JDBC-driver die u wilt implementeren.
Als u bijvoorbeeld gegevens uit een Snowflake database wilt modelleren, downloadt u de meest recente JDBC-driver voor Snowflake (bijvoorbeeld: in het bestand snowflake-jdbc-3.9.0.jar).
Kopieer het gedownloade JAR-bestand voor JDBC naar de installatiemap van Data Gateway.
- In een serverimplementatie kopieert u het JAR-bestand naar: <Data_Gateway_installatielocatie>/domain/jettybase/thirdpartyDrivers.
- Bij een persoonlijke implementatie in Windows kopieert u het JAR-bestand naar: <Data_Gateway_extractiepad>\thirdpartyDrivers.
- Bij een persoonlijke implementatie in MacOS kopieert u het JAR-bestand naar: <Programma->Toon pakketinhoud>Resources->app.nw->thirdPartyDrivers.
Data Gateway opnieuw starten. Zie voor meer informatie: Data Gateway beheren.

DSN-notaties voor het opgeven van gegevensbronnen

In Oracle Analytics kunt u uw lokale gegevens modelleren voor tal van databasetypen. Oracle Analytics biedt ondersteuning voor directe toegang tot bepaalde lokale gegevensbronnen via het semantische model. Wanneer u de databaseverbinding maakt met behulp van Model Administration Tool, gebruikt u voor het veld Naam gegevensbron in het dialoogvenster Verbindingsgroep (tabblad 'Algemeen') de juiste DSN-opmaak voor het databasetype waarmee u verbinding wilt maken.

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