Konfigurácia a registrácia brány dát pre zostavy

Pomocou týchto voliteľných krokov môžete aktivovať vzdialené pripojenie k funkciám klasickej domovskej stránky, ako sú analýzy a panely.

Ak nasadzujete iba na účely vizualizácie dát (napríklad Oracle Analytics Cloud Professional Edition), nemusíte postupovať podľa týchto krokov.
Skôr než začnete, postupujte podľa krokov na konfiguráciu v časti Konfigurácia brány dát pre vizualizáciu dát.
  1. Zistite názov počítača a číslo portu počítača, v ktorom ste nainštalovali agenta brány dát.
    V nasadení servera :
    1. Vykonajte príkaz /<Data Gateway install folder>/domain/bin/status.sh.
    2. Vo výstupe príkazu si poznačte názov počítača uvedený v adrese URL, ktorá je zobrazená v časti Stav brány dát, a poznačte si hodnotu Port HTTP Jetty brány dát.
    V osobnom nasadení:
    1. Otvorte súbor: %localappdata%\Temp\DataGateway\ports.properties.
    2. Poznačte si názov počítača a číslo portu.
  2. Spustite agenta brány dát.
  3. Ak pred začatím pripájania k dátam na diaľku chcete tieto dáta najskôr modelovať, upravte sémantický model pomocou nástrojov Sémantický modelár alebo Model Administration Tool (ak sémantický modelár danú databázu nepodporuje).
  4. Ak používate nástroj Model Administration Tool, zaveďte metadáta dátového zdroja Java.
    1. V ponuke Súbor nástroja Model Administration Tool kliknite na položku Otvoriť, potom na položku V cloude a prostredníctvom dialógového okna Otvoriť v cloude zadajte detaily sémantického modelu.
    2. V ponuke Súbor kliknite na položku Zaviesť dátové zdroje Java.
    3. V dialógovom okne Pripojiť sa na Java Datasource Server:
      • V poli Názov hostiteľa zadajte názov počítača, ktorý ste si poznačili v kroku 1. Zadajte celý názov hostiteľa. Ak ste si v kroku 1 poznačili napríklad machine, môžete zadať machine.us.example.com.
      • V poli Port zadajte číslo portu, ktoré ste si poznačili v kroku 1. Napríklad 51811.
      • V poliach Meno používateľa a Heslo zadajte dummy alebo iný reťazec (tieto doklady nie sú overené, pretože ide o verejné volanie na zistenie funkcií inzerovaných bránou dát).
  5. Ak používate nástroj Model Administration Tool, nastavte pripojenie fyzickej databázy:
    1. Vo fyzickej vrstve vytvorte lokálne (nie vzdialené) pripojenie k dátovému zdroju pomocou štandardného rozhrania volania vhodného pre váš dátový zdroj a podľa potreby modelujte dáta.
    2. Keď budete pripravení vytvoriť vzdialené pripojenie k sémantickému modelu a publikovať ho spätne v cloude, upravte pripojenie, ktoré ste vytvorili.
    3. Na karte Všeobecné vyberte v poli Rozhranie volania položku JDBC (priamy ovládač) a v poli Pripojovací reťazec zadajte reťazec JDBC a doklady v pripojení sémantického modelu. Pozrite si časť Šablóny JDBC a JNDI a príklady nižšie, kde nájdete zoznam podporovaných reťazcov a tried ovládačov JDBC.
    4. Na karte Rôzne v poli Použiť SQL cez HTTP zadajte hodnotu true, v poli Verzia RDC hodnotu 2 a zadajte triedu ovládača JDBC.
    5. Publikujte sémantický model do cloudu.
Teraz môžete nasadenie otestovať prostredníctvom vzdialeného pripojenia k lokálnej databáze.

Šablóny a príklady JDBC a JNDI

Pri nastavovaní vzdialeného pripojenia pre analýzy a panely možno bude potrebné zadať reťazce a triedy ovládačov JDBC a detaily pripojenia a kontextu JNDI.

Vzory reťazcov a triedy ovládačov JDBC
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\"]  
Šablóny JNDI pre natívne ovládače
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" />
Šablóny JNDI pre ovládače 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" 
/>
     

Pridanie ovládača JDBC do brány dát

Do inštalácie brány dát môžete pridať ovládač JDBC, aby ste mohli modelovať dáta v lokálnej databáze.

Skôr než začnete, uistite sa, že brána dát a nástroj Model Administration Tool sú nainštalované v tom istom počítači so systémom Windows v lokálnom prostredí.
  1. Stiahnite si ovládač JDBC, ktorý chcete nasadiť.
    Ak napríklad chcete modelovať dáta v databáze Snowflake, stiahnite si najnovší ovládač Snowflake JDBC (napríklad v súbore snowflake-jdbc-3.9.0.jar).
  2. Skopírujte stiahnutý súbor JAR ovládača JDBC do inštalačného priečinka brány dát.
    • V nasadení servera skopírujte súbor JAR do nasledujúceho priečinka: <umiestnenie inštalácie brány dát>/domain/jettybase/thirdpartyDrivers.
    • Pri osobnom nasadení v systéme Windows skopírujte súbor JAR do nasledujúceho priečinka: <cesta na extrahovanie brány dát>\thirdpartyDrivers.
    • Pri osobnom nasadení v systéme macOS skopírujte súbor JAR do nasledujúceho priečinka: <Application->Show Package Contents>Resources->app.nw-> thirdpartyDrivers.
  3. Reštartujte bránu dát. Pozrite si časť Údržba brány dát.

Formáty DSN používané pri zadávaní dátových zdrojov

V službe Oracle Analytics môžete modelovať lokálne dáta pre mnohé typy databáz. Služba Oracle Analytics podporuje priamy prístup k niektorým lokálnym dátovým zdrojom prostredníctvom sémantického modelu. Keď vytvárate databázové pripojenie pomocou nástroja Model Administration Tool, v poli Názov dátového zdroja v dialógovom okne Spoločná oblasť pripojení (na karte Všeobecné) použijete vhodný formát DSN pre typ databázy, ku ktorej sa pripájate.

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