تكوين Data Gateway وتسجيلها لإعداد التقارير

قم بتنفيذ هذه الخطوات الاختيارية لتمكين الاتصال عن بُعد للميزات الكلاسيكية مثل التحليلات ولوحات المعلومات.

إذا كنت تقوم بتوزيع بتمثيل مرئي للبيانات فقط (على سبيل المثال، إصدار Oracle Analytics Cloud للمحترفين)، فلن تحتاج إلى أداة اتباع هذه الخطوات.

قبل البدء، اتبع خطوات التكوين في تكوين Data Gateway للتمثيل المرئي.

من الجهاز الذي يتم فيه تثبيت عمل Data Gateway، احصل على اسم الجهاز ورقم المنفذ.
في توزيع الخادم:
1. قم بتنفيذ الأمر /<Data Gateway install folder>/domain/bin/status.sh.
2. في مخرجات الأمر، دوِّن اسم الجهاز المتضمن داخل عنوان URL المعروض أسفل حالة Data Gateway، ودوِّن قيمة منفذ Jetty HTTP في Data Gateway.
في التوزيع الشخصي:
1. افتح الملف التالي: %localappdata%\Temp\DataGateway\ports.properties.
2. دوِّن اسم الجهاز ورقم المنفذ.
ابدأ عميل Data Gateway.
إذا كنت تريد إنشاء نماذج لبياناتك قبل بدء الاتصال بها عن بُعد، فاستخدم أداة إنشاء النماذج الدلالية أو أداة إدارة النماذج (إذا لم تكن قاعدة البيانات مدعومة بواسطة أداة إنشاء النماذج الدلالية) لتحرير نموذجك الدلالي.
إذا كنت تستخدم Model Administration Tool، فقم بتحميل بيانات التعريف الخاصة بمصدر بيانات Java.
1. في Model Administration Tool، من قائمة ملف، انقر على فتح، ثم على في السحابة، واستخدم مربع الحوار "فتح في السحابة" لتحديد بيانات الاتصال بالنموذج الدلالي.
2. من القائمة ملف، انقر على تحميل مصادر بيانات جافا.
3. في مربع الحوار اتصال بخادم مصدر بيانات جافا:
  - في حقل اسم المضيف، أدخل اسم الجهاز الذي دوَّنته في الخطوة 1. قم بتأهيل اسم المضيف بشكل كامل. على سبيل المثال، إذا دوَّنت الجهاز في الخطوة 1، يمكنك تحديد machine.us.example.com.
  - في حقل المنفذ، أدخل المنفذ الذي دوَّنته في الخطوة 1. على سبيل المثال، 51811.
  - في حقلي اسم المستخدم وكلمة السر، أدخل dummy أو أي سلسلة (لا يتم التحقق من صحة بيانات الاعتماد هذه لأن هذا استدعاء عام للكشف عن الإمكانات التي تم الإعلان عنها بواسطة Data Gateway).
إذا كنت تستخدم Model Administration Tool، فقم بإعداد اتصال فعلي بقاعدة البيانات:
1. في الطبقة الفعلية، قم بتكوين اتصال محلي (غير بعيد) بمصدر البيانات مستخدمًا واجهة الاتصال القياسية الملائمة لمصدر البيانات، مع إعداد نموذج للبيانات حسب الحاجة.
2. عندما تكون جاهزًا لإنشاء اتصال بعيد بنموذجك الدلالي ونشره مرة أخرى للسحابة، قم بتحرير الاتصال الذي أنشأته.
3. في علامة تبويب عام، في حقل واجهة الاتصال، حدد JDBC (برنامج تشغيل مباشر)، وفي حقل سلسلة الاتصال، حدد سلسلة JDBC والصلاحيات في اتصال النموذج الدلالي. اطَّلع على قوالب وأمثلة لـ JDBC وJNDI أدناه للحصول على قائمة بسلاسل JDBC المدعومة وفئات برنامج التشغيل.
4. في علامة التبويب متنوع، أدخل true في حقل استخدام SQL على HTTP، وأدخل 2 في حقل إصدار RDC، وحدد فئة برنامج تشغيل JDBC.
5. انشر النموذج الدلالي على السحابة.

أنت الآن مستعد لاختبار توزيعك عن طريق الاتصال عن بُعد بقاعدة بيانات محلية.

قوالب JDBC وJNDI وأمثلتها

عندما تقوم بإعداد الاتصال عن بُعد للتحليلات ولوحات المعلومات، قد يتعين عليك تحديد سلاسل 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 في بيئة العمل المحلية.

قم بتنزيل برنامج تشغيل JDBC الذي تريد توزيعه.
على سبيل المثال، لنمذجة البيانات في قاعدة بيانات Snowflake، قم بتنزيل أحدث إصدار من برنامج تشغيل Snowflake JDBC (على سبيل المثال، في ملف snowflake-jdbc-3.9.0.jar).
قم بنسخ ملف JDBC JAR الذي تم تنزيله إلى مجلد تثبيت Data Gateway.
- في توزيع خادم، انسخ ملف 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.
إعادة بدء 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"]