Konfigurera och registrera datanätslussen för rapportering

Utför dessa valfria steg för att aktivera fjärranslutning för klassiska funktioner, t.ex. analyser och infopaneler.

Om du bara distribuerar för datavisualisering (t.ex. den professionella utgåvan av Oracles analysmoln) behöver du inte följa de här stegen.

Innan du börjar ska du följa konfigurationsstegen i Konfigurera datanätslussen för datavisualisering.

Hämta datornamn och portnummer på den dator där du har installerat en datanätslussagent.
I en serverdistribution:
1. Kör kommandot /<Data Gateway install folder>/domain/bin/status.sh.
2. Notera, i utdata för kommandot, datornamnet som finns i den URL som visas under Status för datanätsluss samt värdet för Jetty HTTP-port för datanätsluss.
I en personlig distribution:
1. Öppna filen: %localappdata%\Temp\DataGateway\ports.properties.
2. Notera datornamnet och portnumret.
Starta datanätslussagenten.
Om du vill modellera dina data innan du börjar fjärransluta till dem använder du semantikmodelleraren eller modelladministrationsverktyget (om databasen inte stöds av semantikmodelleraren) för redigering av den semantiska modellen.
Om du använder modelladministrationsverktyget laddar du Java-datakällans metadata.
1. På menyn Arkiv i modelladministrationsverktyget klickar du på Öppna och sedan på I molnet. Ange sedan informationen om den semantiska modellen i dialogrutan Öppna i molnet.
2. På menyn Arkiv klickar du på Ladda Java-datakällor.
3. I dialogrutan Anslut till Java-datakällserver:
  - I fältet Värdnamn anger du datornamnet som du noterade i steg 1. Kvalificera värdnamnet fullständigt. Om du till exempel noterade machine i steg 1 kan du ange machine.us.example.com.
  - I fältet Port anger du porten som du noterade i steg 1. Exempel: 51811.
  - I fälten Användarnamn och Lösenord anger du dummy eller valfri sträng (de här inloggningsuppgifterna valideras inte eftersom det här är ett allmänt anrop för att upptäcka de funktioner som annonseras av datanätslussen).
Om du använder modelladministrationsverktyget ställer du in en fysisk databasanslutning:
1. I hårdvarulagret skapar du en lokal anslutning (inte fjärranslutning) till datakällan med det standardanropsgränssnitt som är lämpligt för datakällan, och modellerar data efter behov.
2. När du är klar att upprätta en fjärranslutning till den semantiska modellen och publicera tillbaka den till molnet redigerar du anslutningen som du har skapat.
3. På fliken Allmänt, i fältet Anropsgränssnitt, väljer du JDBC (direkt drivrutin), och i fältet Anslutningssträng anger du JDBC-strängen och inloggningsuppgifterna i anslutningen till den semantiska modellen. Se JDBC- och JNDI-mallar med exempel nedan för en lista över JDBC-strängar och drivrutinsklasser som stöds.
4. På fliken Övrigt, i fältet Använd SQL över HTTP, anger du sant, och i fältet RDC-version anger du 2. Ange även JDBC-drivrutinsklass.
5. Publicera den semantiska modellen till molnet.

Du är nu klar att testa distributionen genom att fjärransluta till en lokal databas.

JDBC- och JNDI-mallar med exempel

När du ställer in fjärranslutning av analyser och infopaneler kan du behöva ange JDBC-strängar och -drivrutinsklasser och JNDI-anslutningsdetaljer och -kontextdetaljer.

JDBC-strängmönster och -drivrutinsklasser

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-mallar för ursprungliga drivrutiner

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-mallar för DD-drivrutiner

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

Lägg till en JDBC-drivrutin i Data Gateway

Lägg till en JDBC-drivrutin i din Data Gateway-installation så att du kan modellera data i en lokal databas.

Innan du börjar kontrollerar du att Data Gateway och modelladministrationsverktyget är installerade på samma Windows-dator i din lokala miljö.

Ladda ned JDBC-drivrutinen du vill distribuera.
Du kan exempelvis ladda ned den senaste Snowflake JDBC-drivrutinen om du vill modellera data i en Snowflake-databas (till exempel i filen snowflake-jdbc-3.9.0.jar).
Kopiera den nedladdade JDBC JAR-filen till installationsmappen för Data Gateway.
- I en serverdistribution kopierar du JAR-filen till: <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers.
- I en personlig distribution i Windows kopierar du JAR-filen till: <Data Gateway_extract_path>\thirdpartyDrivers.
- I en personlig distribution i MacOS kopierar du JAR-filen till: <Application->Show Package Contents>Resources->app.nw-> thirdpartyDrivers.
Starta om datanätslussen. Se Underhåll datanätslussen.

DSN-format för att ange datakällor

I Oracle Analytics kan du modellera dina lokala data för många databastyper. Oracle Analytics stöder direkt åtkomst till vissa lokala datakällor genom den semantiska modellen. När du skapar databasanslutningen med modelladministrationsverktyget använder du lämpligt DSN-format för databastypen du ansluter till i fältet Datakälla i dialogrutan Anslutningspool (fliken Allmänt).

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