Konfigurere og registrere Data Gateway til rapportering

Udfør disse valgfrie trin for at aktivere eksterne forbindelser for klassiske funktioner såsom analyser og instrumentbrætter.

Hvis du kun ibrugtager til datavisualisering (for eksempel Oracle Analytics Cloud Professional Edition), behøver du ikke at følge disse trin.

Inden du starter, skal du følge konfigurationstrinnene i Konfigurere Data Gateway til datavisualisering.

Få navn og portnr. på den maskine, hvor du installerede en Data Gateway-agent.
I en serveribrugtagning:
1. Udfør kommandoen /<Data Gateway-installationsmappe>/domain/bin/status.sh.
2. Bemærk det integrerede maskinnavn i den URL, som vises under Data Gateway Status i kommandooutputtet, og bemærk Data Gateway Jetty HTTP Port-værdien.
I en personlig ibrugtagning:
1. Åbn filen: %localappdata%\Temp\DataGateway\ports.properties.
2. Bemærk maskinens navn og portnr.
Start Data Gateway-agenten.
Hvis du vil modellere dine data, før du begynder at oprette ekstern forbindelse til dem, skal du bruge Semantic Modeler eller Model Administration Tool (hvis Semantic Modeler ikke understøtter databasen) til at redigere din semantiske model.
Hvis du bruger Model Administration Tool, skal du indlæse metadataene for Java-datakilden:
1. Klik på Åbn og derefter I clouden i menuen Fil i Model Administration Tool, og brug dialogboksen Åbn i clouden til at angive detaljer for din semantiske model.
2. Klik på Indlæs Java-datakilder i menuen Fil.
3. I dialogboksen Tilsluttet Java-datakildeserver:
  - Angiv det maskinnavn, som du noterede i trin 1, i feltet Værtsnavn. Komplet værtsnavn Hvis du for eksempel noterede machine i trin 1, angiver du måske machine.us.example.com.
  - Angiv den port, som du noterede i trin 1, i feltet Port. For eksempel 51811.
  - Indtast dummy eller en streng (disse ID-oplysninger valideres ikke, fordi det er et offentligt opkald til at registrere de funktioner, som er annonceret af Data Gateway) i felterne Brugernavn og Adgangskode.
Hvis du bruger Model Administration Tool, skal du konfigurere en fysisk databaseforbindelse:
1. I det fysiske lag skal du oprette en lokal (ikke-ekstern) forbindelse til din datakilde ved hjælp af det standardkaldinterface, der passer til datakilden, og modellere dataene efter behov.
2. Når du er klar til at oprette en ekstern forbindelse til din semantiske model og publicere den tilbage i clouden, kan du redigere den forbindelse, som du har oprettet.
3. På fanen Generelt skal du i feltet Kaldinterface vælge JDBC (direkte driver), og i feltet Forbindelsesstreng skal du angive JDBC-strengen og legitimationsoplysningerne i forbindelsen for den semantiske model. Se JDBC- og JNDI-skabeloner og -eksempler nedenfor for en liste over understøttede JDBC-strenge og -driverklasser.
4. På fanen Diverse skal du angive sand i feltet Brug SQL over HTTP og 2 i feltet RDC-version og angive JDBC-driverklassen.
5. Publicer den semantiske model til clouden.

Du er nu klar til at teste din ibrugtagning ved at oprette en ekstern forbindelse til en lokal database.

JDBC- og JNDI-skabeloner og -eksempler

Når du konfigurerer eksterne forbindelser til analyser og instrumentbrætter, skal du muligvis angive JDBC-strenge og driverklasser samt JNDI-forbindelsesdetaljer 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-skabeloner til oprindelige 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-skabeloner til 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" 
/>

Føje en JDBC-driver til Data Gateway

Føj en JDBC-driver til din Data Gateway-installation, så du kan modellere data i en lokal database.

Før du starter, skal du sørge for, at Data Gateway og Model Administration Tool er installeret på den samme Windows-computer i dit lokale miljø.

Download den JDBC-driver, som du vil tage i brug.
Hvis du vil modellere data i en Snowflake-database, skal du for eksempel downloade den nyeste Snowflake-JDBC-driver (for eksempel i filen snowflake-jdbc-3.9.0.jar).
Kopier den downloadede JDBC JAR-fil til Data Gateway-installationsmappen.
- I en serveribrugtagning skal du kopiere JAR-filen til: <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers.
- I en personlig ibrugtagning i Windows skal du kopiere JAR-filen til: <Data Gateway_extract_path>\thirdpartyDrivers.
- I en personlig ibrugtagning i MacOS skal du kopiere JAR-filen til: <Application->Show Package Contents>Resources->app.nw-> thirdpartyDrivers.
Genstart Data Gateway. Se Vedligeholde Data Gateway.

DSN-formater til angivelse af datakilder

I Oracle Analytics kan du modellere dine lokale data for mange databasetyper. Oracle Analytics understøtter direkte adgang til nogle lokale datakilder via den semantiske model. Når du opretter databaseforbindelsen ved hjælp af Model Administration Tool, skal du i feltet Datakildenavn i dialogboksen Forbindelsespulje (fanen Generelt) bruge det DSN-format, der passer til den database, som du opretter forbindelse 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"]