Konfigurere og registrere Data Gateway for rapportering

Du kan utføre disse valgfrie trinnene hvis du vil aktivere ekstern tilkobling for klassiske funksjoner som analyser og instrumentpaneler.

Hvis du bare implementerer datavisualisering (for eksempel Oracle Analytics Cloud Professional Edition), trenger du ikke å utføre disse trinnene.

Før du begynner, må du følge konfigurasjonstrinnene i Konfigurere Data Gateway for datavisualisering.

Finn maskinnavnet og portnummeret for maskinen som du har installert en agent for Data Gateway på.
I en tjenerimplementering:
1. Utfør kommandoen /<Installasjonsmappe for Data Gateway>/domain/bin/status.sh.
2. I utdataene for kommandoen noterer du deg maskinnavnet i URL-adressen som vises under Status for Data Gateway. Noter deg også verdien for HTTP-port for Jetty for Data Gateway.
I en personlig implementering:
1. Åpne filen %localappdata%\Temp\DataGateway\ports.properties.
2. Noter deg maskinnavnet og portnummeret.
Start agenten for Data Gateway.
Hvis du vil modellere dataene før du begynner å koble til dem eksternt, bruker du semantisk modellerer eller modelladministrasjonsverktøyet (hvis databasen ikke støttes av semantisk modellerer) til å redigere den semantiske modellen.
Hvis du bruker modelladministrasjonsverktøyet, laster du metadataene for Java-datakilden:
1. Klikk på Åpne på menyen Fil i Model Administration Tool, klikk deretter på I skyen, og bruk dialogboksen Åpne i skyen til å angi detaljene om den semantiske modellen.
2. Klikk på Last Java-datakilder på menyen Fil.
3. Gjør følgende i dialogboksen Koble til Java-datakildetjener:
  - Angi maskinnavnet du har notert deg i trinn 1, i feltet Vertsnavn. Gjør vertsnavnet fullstendig kvalifisert. Hvis du for eksempel har notert deg machine i trinn 1, kan du angi machine.us.example.com.
  - Angi porten du har notert deg i trinn 1, i feltet Port. For eksempel 51811.
  - Angi dummy eller en hvilken som helst streng (disse påloggingsopplysningene valideres ikke fordi dette er et offentlig kall for å oppdage funksjonene annonsert av Data Gateway), i feltene Brukernavn og Passord.
Hvis du bruker modelladministrasjonsverktøyet, konfigurerer du en fysisk databasetilkobling:
1. I det fysiske laget oppretter du en lokal (ikke ekstern) tilkobling til datakilden ved hjelp av standardgrensesnittet for kall som er egnet for datakilden, og modellerer dataene etter behov.
2. Når du er klar til å gjøre en ekstern tilkobling til den semantiske modellen og publisere den tilbake til skyen, redigerer du tilkoblingen du har opprettet.
3. Velg JDBC (direkte driver) i feltet Kallgrensesnitt i fanen Generelt, og angi JDBC-strengen og påloggingsopplysningene for tilkoblingen for den semantiske modellen i feltet Tilkoblingsstreng. Hvis du vil ha en liste over støttede JDBC-strenger og -driverklasser, kan du se Maler og eksempler for JDBC og JNDI nedenfor.
4. Angi Sann i feltet Bruk SQL over HTTP i fanen Diverse, angi 2 i feltet RDC-versjon, og angi JDBC-driverklassen.
5. Publiser den semantiske modellen til skyen.

Du er nå klar til å teste implementeringen ved å koble til eksternt til en lokal database.

Maler og eksempler for JDBC og JNDI

Når du konfigurerer ekstern tilkobling for analyser og instrumentpaneler, kan det hende at du må angi JDBC-strenger og -driverklasser, JNDI-tilkoblingsdetaljer og kontekstdetaljer.

JDBC-strengmønstre og -driverklasser

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-maler for lokale drivere

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-maler for DD-drivere

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

Legge til en JDBC-driver i Data Gateway

Legg til en JDBC-driver i Data Gateway-installasjonen slik at du kan modellere data i en lokal database.

Før du begynner, må du forsikre deg om at Data Gateway og Model Administration Tool er installert på samme Windows-datamaskin i det lokale miljøet.

Last ned JDBC-driveren du vil implementere.
Hvis du for eksempel vil modellere data i en Snowflake-database, laster du ned den nyeste JDBC-driveren for Snowflake (for eksempel i filen snowflake-jdbc-3.9.0.jar).
Kopier den nedlastede JAR-filen for JDBC til installasjonsmappen for Data Gateway.
- I en tjenerimplementering kopierer du JAR-filen til <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers.
- I en personlig implementering på Windows kopierer du JAR-filen til <Data Gateway_extract_path>\thirdpartyDrivers.
- I en personlig implementering på MacOS kopierer du JAR-filen til <Applikasjon->Vis pakkeinnhold>Ressurser->app.nw-> thirdpartyDrivers.
Start Data Gateway på nytt. Se Vedlikeholde Data Gateway.

DSN-formater for angivelse av datakilder

Du kan modellere de lokale dataene for mange databasetyper i Oracle Analytics. Oracle Analytics støtter direkte tilgang til enkelte lokale datakilder via den semantiske modellen. Når du oppretter en databasetilkobling ved hjelp av Model Administration Tool, bruker du feltet Datakildenavn i dialogboksen Tilkoblingsreserve (fanen Generelt) til å angi riktig DSN-format for databasetypen du kobler til.

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