Configurarea şi înregistrarea Data Gateway pentru raportare

Parcurgeţi aceşti paşi opţionali pentru a permite conectivitatea de la distanţă pentru funcţionalităţile Classic, precum analize şi dashboarduri.

Dacă implementaţi numai pentru vizualizarea datelor (de exemplu, Oracle Analytics Cloud Professional Edition), atunci nu este necesar să urmaţi aceşti paşi.

Înainte de a începe, urmaţi paşii de configurare din Configurarea Data Gateway pentru Data Visualization.

Pe calculatorul pe care aţi instalat un agent Data Gateway, obţineţi numele calculatorului şi numărul portului.
Într-o implementare de server:
1. Executaţi comanda /<Data Gateway install folder>/domain/bin/status.sh.
2. În rezultatul comenzii, notaţi numele calculatorului conţinut în URL-ul afişat sub Stare Data Gateway şi notaţi valoarea Portului HTTP Data Gateway Jetty.
Într-o implementare personală:
1. Deschideţi fişierul: %localappdata%\Temp\DataGateway\ports.properties.
2. Notaţi numele calculatorului şi numărul portului.
Porniţi agentul Data Gateway.
Dacă doriţi să modelaţi datele înainte de a vă conecta de la distanţă la acestea, utilizaţi Semantic Modeler sau Model Administration Tool (dacă baza de date nu este acceptată de Semantic Modeler) pentru a edita modelul semantic.
Dacă utilizaţi Model Administration Tool, încărcaţi metadatele sursei de date Java.
1. În Model Administration Tool, din meniul Fişier, faceţi clic pe Deschidere, apoi În Cloud şi utilizaţi caseta de dialog Deschidere în Cloud pentru a specifica detaliile modelului dvs. semantic.
2. Din meniul Fişier, faceţi clic pe Încărcare surse de date Java.
3. În dialogul Conectare la serverul Java de surse de date:
  - În câmpul Nume gazdă, introduceţi numele calculatorului pe care l-aţi notat la pasul 1. Specificaţi numele complet al gazdei. De exemplu, dacă aţi notat calculator la pasul 1, puteţi specifica calculator.us.exemplu.com.
  - În câmpul Port, introduceţi portul pe care l-aţi notat la pasul 1. De exemplu, 51811.
  - În câmpurile Nume de utilizator şi Parolă, introduceţi fictiv sau orice şir (aceste acreditări nu sunt validate, deoarece acesta este un apel public pentru a descoperi capacităţile promovate de Data Gateway).
Dacă utilizaţi Model Administration Tool, configuraţi o conexiune la baza de date fizică.
1. În stratul fizic, creaţi o conexiune locală (nu una la distanţă) la sursa de date utilizând interfaţa de apel standard corespunzătoare sursei de date şi modelaţi datele după cum este nevoie.
2. Când sunteţi pregătit să creaţi o conexiune de la distanţă la modelul dvs. semantic şi să-l publicaţi înapoi în cloud, editaţi conexiunea creată.
3. În fila General, în câmpul Interfaţă de apel, selectaţi JDBC (Direct Driver), iar în câmpul Şir de conectare, specificaţi şirul şi acreditările JDBC în conexiunea modelului semantic. Consultaţi Şabloanele şi exemplele JDBC şi JNDI de mai jos pentru a vedea o listă cu şirurile JDBC şi clasele de drivere JDBC acceptate.
4. În fila Diverse, în câmpul Utilizare SQL prin HTTP, introduceţi Adevărat, iar în câmpul Versiune RDC introduceţi 2 şi specificaţi clasa de drivere JDBC.
5. Publicaţi modelul semantic în cloud.

Acum sunteţi pregătit să testaţi implementarea prin conectarea de la distanţă la o bază de date de la sediu.

Şabloane şi exemple JDBC şi JNDI

Atunci când configuraţi o conexiune la distanţă pentru analize şi dashboarduri, ar putea fi necesar să specificaţi şiruri JDBC şi clase de drivere, precum şi detaliile conexiunii JNDI şi detaliile contextului.

Tipare de şiruri JDBC şi clase de drivere

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

Şabloane JNDI pentru drivere native

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

Şabloane JNDI pentru drivere DD

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

Adăugarea unui driver JDBC la Data Gateway

Adăugaţi un driver JDBC la instalarea dvs. Data Gateway, pentru a putea modela datele dintr-o bază de date de la sediu.

Înainte de a începe, verificaţi ca Data Gateway şi Model Administration Tool să fie instalate pe acelaşi computer cu Windows din mediul dvs. la sediu.

Descărcaţi driverul JDBC pe care doriţi să-l implementaţi.
De exemplu, pentru a modela datele într-o bază de date Snowflake, descărcaţi cel mai recent driver Snowflake JDBC (de exemplu, în fişierul snowflake-jdbc-3.9.0.jar).
Copiaţi fişierul JAR JDBC descărcat în folderul de instalare Data Gateway.
- Într-o implementare pe server, copiaţi fişierul JAR în: <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers.
- Într-o implementare personală din Windows, copiaţi fişierul JAR în: <Data Gateway_extract_path>\thirdpartyDrivers.
- Într-o implementare personală din MacOS, copiaţi fişierul JAR în: <Application->Show Package Contents>Resources->app.nw-> thirdpartyDrivers.
Reporniţi Data Gateway. Consultaţi Întreţinerea Data Gateway.

Formate DSN pentru specificarea surselor de date

În Oracle Analytics puteţi modela datele la sediu pentru multe tipuri de baze de date. Oracle Analytics acceptă accesul direct la unele surse de date la sediu prin modelul semantic. Când creaţi conexiunea bazei de date utilizând instrumentul Model Administration Tool, în câmpul Nume sursă de date din dialogul Centralizator de conexiuni (fila General) utilizaţi formatul DSN corespunzător pentru tipul de bază de date la care vă conectaţi.

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