Διαμόρφωση και εγγραφή του Data Gateway για δημιουργία αναφορών

Εκτελέστε αυτά τα προαιρετικά βήματα για να είναι δυνατή η απομακρυσμένη συνδεσιμότητα για λειτουργίες του Classic, όπως αναλύσεις και dashboard.

Αν κάνετε ανάπτυξη μόνο για απεικόνιση δεδομένων (π.χ. Oracle Analytics Cloud Professional Edition), δεν χρειάζεται να ακολουθήσετε αυτά τα βήματα.
Πριν ξεκινήσετε, ακολουθήστε τα βήματα διαμόρφωσης που περιγράφονται στην ενότητα Διαμόρφωση του Data Gateway για απεικόνιση δεδομένων.
  1. Στον υπολογιστή όπου έχετε εγκαταστήσει έναν παράγοντα του Data Gateway, αποκτήστε το όνομα και τον αριθμό θύρας του υπολογιστή.
    Σε μια ανάπτυξη server:
    1. Εκτελέστε την εντολή /<Data Gateway install folder>/domain/bin/status.sh.
    2. Στα αποτελέσματα εξόδου της εντολής, σημειώστε το όνομα υπολογιστή που περιέχεται στη Διεύθυνση τοποθεσίας που εμφανίζεται κάτω από την ένδειξη "Κατάσταση Data Gateway και σημειώστε την τιμή "Θύρα HTTPJetty Data Gateway".
    Σε μια προσωπική ανάπτυξη:
    1. Ανοίξτε το αρχείο: %localappdata%\Temp\DataGateway\ports.properties.
    2. Σημειώστε το όνομα και τον αριθμό θύρας του υπολογιστή.
  2. Εκκίνηση του παράγοντα του Data Gateway.
  3. Αν θέλετε να μοντελοποιήσετε τα δεδομένα σας πριν αρχίσετε να συνδέεστε απομακρυσμένα σε αυτά, χρησιμοποιήστε το Semantic Modeler ή το Model Administration Tool (αν η βάση δεδομένων δεν υποστηρίζεται από το Semantic Modeler) για να επεξεργαστείτε το σημασιολογικό μοντέλο.
  4. Αν χρησιμοποιείτε το Model Administration Tool, φορτώστε τα μεταδεδομένα πηγής δεδομένων Java.
    1. Στο Εργαλείο διαχείρισης μοντέλων, από το μενού Αρχείο, κάντε κλικ στην επιλογή Άνοιγμα και κατόπιν στην επιλογή Στο Cloud και χρησιμοποιήστε το παράθυρο διαλόγου "Άνοιγμα στο Cloud", για να καθορίσετε τις λεπτομέρειες του σημασιολογικού μοντέλου σας.
    2. Από το μενού "Αρχείο" , πατήστε "Φόρτωση προελεύσεων δεδομένων Java".
    3. Στο παράθυρο διαλόγου "Σύνδεση στον server προέλευσης δεδομένων Java":
      • Στο πεδίο "Όνομα κεντρικού υπολογιστή", εισαγάγετε το όνομα υπολογιστή που σημειώσατε στο Βήμα 1. Προσδιορίστε πλήρως το όνομα κεντρικού υπολογιστή. Για παράδειγμα, εάν σημειώσατε machine στο Βήμα 1, πρέπει να ορίσετε machine.us.example.com.
      • Στο πεδίο "Θύρα", εισαγάγετε τη θύρα υπολογιστή που σημειώσατε στο Βήμα 1. Για παράδειγμα, 51811.
      • Στα πεδία "Όνομα χρήστη" και "Κωδικός πρόσβασης", εισαγάγετε dummy ή οποιαδήποτε συμβολοσειρά (αυτά τα διαπιστευτήρια δεν επικυρώνονται επειδή αυτή είναι μια δημόσια κλήση για να ανακαλύψετε τις δυνατότητες που διαφημίζονται από το Data Gateway).
  5. Αν χρησιμοποιείτε το Model Administration Tool, ρυθμίστε μια σύνδεση φυσικής βάσης δεδομένων:
    1. Στο Φυσικό επίπεδο, δημιουργήστε μια τοπική (όχι απομακρυσμένη) σύνδεση στην προέλευση δεδομένων σας, χρησιμοποιώντας την τυπική διασύνδεση κλήσης που είναι κατάλληλη για την προέλευση δεδομένων και μοντελοποιήστε τα δεδομένα όπως απαιτείται.
    2. Όταν είστε έτοιμοι να συνδεθείτε απομακρυσμένα στο σημασιολογικό μοντέλο σας και να το δημοσιεύσετε πάλι στο cloud, επεξεργαστείτε τη σύνδεση που δημιουργήσατε.
    3. Στην καρτέλα Γενικά, επιλέξτε JDBC (Άμεσο πρόγραμμα οδήγησης) στο πεδίο Διασύνδεση κλήσης και ορίστε τη συμβολοσειρά JDBC και τα διαπιστευτήρια για τη σύνδεση σημασιολογικού μοντέλου στο πεδίο Συμβολοσειρά σύνδεσης. Δείτε την ενότητα "Πρότυπα και παραδείγματα JDBC και JNDI" παρακάτω για μια λίστα υποστηριζόμενων συμβολοσειρών JDBC και κλάσεων προγραμμάτων οδήγησης.
    4. Στην καρτέλα Διάφορα, καταχωρίστε την τιμή true στο πεδίο Χρήση SQL μέσω HTTP, καταχωρίστε την τιμή 2 στο πεδίο Έκδοση RDC και ορίστε την κλάση προγράμματος οδήγησης JDBC.
    5. Δημοσιεύστε το σημασιολογικό μοντέλο στο cloud.
Είστε έτοιμοι τώρα να δοκιμάσετε την ανάπτυξή σας μέσω της απομακρυσμένης σύνδεσης σε μια βάση δεδομένων εσωτερικής εγκατάστασης.

Πρότυπα και παραδείγματα JDBC και JNDI

Όταν ρυθμίζετε την απομακρυσμένη συνδεσιμότητα για αναλύσεις και dashboard, ίσως χρειαστεί να καθορίσετε συμβολοσειρές JDBC και κλάσεις προγράμματος οδήγησης καθώς και λεπτομέρειες σύνδεσης και περιβάλλοντος JNDI.

Μοτίβα συμβολοσειράς και κλάσεις προγράμματος οδήγησης 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\"]
Πρότυπα JNDI για εγγενή προγράμματα οδήγησης
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 για προγράμματα οδήγησης 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" 
/>

Προσθήκη ενός προγράμματος οδήγησης JDBC στο Data Gateway

Προσθέστε ένα πρόγραμμα οδήγησης JDBC στην εγκατάσταση Data Gateway, ώστε να μπορείτε να μοντελοποιείτε δεδομένα σε μια βάση δεδομένων εσωτερικής εγκατάστασης.

Πριν ξεκινήσετε, βεβαιωθείτε ότι το Data Gateway και το Model Administration Tool είναι εγκατεστημένα στον ίδιο υπολογιστή Windows στο περιβάλλον εσωτερικής εγκατάστασης.
  1. Κάντε λήψη του προγράμματος οδήγησης JDBC, το οποίο θέλετε να αναπτύξετε.
    Για παράδειγμα, για να μοντελοποιήσετε δεδομένα σε μια βάση δεδομένων Snowflake, κάντε λήψη του πιο πρόσφατου προγράμματος οδήγησης JDBC του Snowflake (για παράδειγμα, στο αρχείο snowflake-jdbc-3.9.0.jar).
  2. Αντιγράψτε το αρχείο λήψης JDBC JAR στον φάκελο εγκατάστασης του Data Gateway.
    • Σε μια ανάπτυξη server, αντιγράψτε το αρχείο JAR στην τοποθεσία: <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers.
    • Σε μια προσωπική ανάπτυξη στα Windows, αντιγράψτε το αρχείο JAR στην τοποθεσία: <Data Gateway_extract_path>\thirdpartyDrivers.
    • Σε μια προσωπική ανάπτυξη στο MacOS, αντιγράψτε το αρχείο JAR στην τοποθεσία: <Application->Show Package Contents>Resources->app.nw-> thirdpartyDrivers.
  3. Επανεκκινήστε το Data Gateway. Ανατρέξτε στην ενότητα Συντήρηση του Data Gateway.

Μορφές DSN για καθορισμό των προελεύσεων δεδομένων

Στο Oracle Analytics μπορείτε να μοντελοποιήσετε τα δεδομένα εσωτερικής εγκατάστασης για πολλούς τύπους βάσεων δεδομένων. Το Oracle Analytics υποστηρίζει απευθείας πρόσβαση σε ορισμένες προελεύσεις δεδομένων εσωτερικής εγκατάστασης μέσω του σημασιολογικού μοντέλου. Όταν δημιουργείτε τη σύνδεση βάσης δεδομένων χρησιμοποιώντας το Model Administration Tool, στο πεδίο Όνομα προέλευσης δεδομένων του παραθύρου διαλόγου Χώρος συγκέντρωσης συνδέσεων (καρτέλα Γενικά), πρέπει να χρησιμοποιήσετε την κατάλληλη μορφή DSN για τον τύπο βάσης δεδομένων στον οποίο συνδέεστε.

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