يمكنك تكوين الاتصالات وتحديثها وإزالتها ومشاركتها في مصادر البيانات. بصفتك مستخدم Oracle Analytics بوصول مؤلف محتوى DV، يمكنك تنفيذ الإجراءات التالية.
الموضوعات:
يمكنك تحديث تفاصيل اتصال مصدر بيانات.
إذا كنت تقوم بتحرير اتصال SSL بقاعدة بيانات أوراكل وكنت بحاجة لاستخدام ملف cwallet.sso
جديد، فعليك في حقل حافظة العميل بالنقر على تحديد للاستعراض وصولاً إلى ملف cwallet.sso
. اطلب من المسئول تحديد موقع ملف cwallet.sso
.
يمكنك إزالة اتصال مصدر بيانات من Oracle Analytics Cloud. على سبيل المثال، يتعين عليك حذف اتصال قاعدة بيانات وتكوين اتصال جديد عند تغيير كلمة سر قاعدة البيانات.
إذا كان الاتصال يشتمل على أي مصادر بيانات، فسيلزم حذف مصادر البيانات قبل التمكن من حذف الاتصال.
يمكنك تعيين أذونات الوصول إلى اتصالات مصدر البيانات التي تكونها أو تديرها.
عند تحديد بيانات الاتصال باستخدام مربع حوار تكوين اتصال أو فحص، فسيتبين لك أن بعض أنواع قواعد البيانات تحتوي على خيارات تكوين إضافية.
خيارات عامة
sales.example.com =(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.111)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.222)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.333)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME= salesservice.example.com)))
تمكين النسخ المتماثل المجمع - إذا كنت تقوم بتحميل مجموعة بيانات لمصنف، فيجب إيقاف تشغيل هذا الخيار ويمكنك تجاهله. فهذا الخيار محجوز لتحليلات البيانات والمستخدمين المتقدمين لإجراء النسخ المتماثل للبيانات من قاعدة بيانات إلى قاعدة بيانات أخرى.
خيارات التصديق
الاتصال بالنظام
انقر على نسخ، لنسخ معرف كائن الاتصال. يمكن أن تلصق أدوات إنشاء نماذج الأعمال معرف الكائن لتحديد اتصال بيانات واستخدامه في Model Administration Tool (مربع حوار مجمع الاتصالات).
ملاحظة: إذا لم تنقر على اتصال النظام عند تكوين الاتصال في البداية، إذا كنت تريد لاحقًا أن تستخدم أدوات إنشاء النماذج تفاصيل الاتصال، يجب عليك عندئذٍ تكوين اتصال جديد وتحديد اتصال النظام. بعبارة أخرى، لا يمكنك تحرير الاتصال لاحقًا وتحديد هذا الخيار.
يجب فهم متطلبات الاتصال لقاعدة البيانات قبل تكوين اتصال قاعدة البيانات.
الحد الأقصى لعدد جداول قواعد البيانات المعروضة في Oracle Analytics هو 10,000. إذا كنت تحتاج لمزيد من الجداول، توصي Oracle بأن تتواصل مع مسؤول قاعدة البيانات لديك لطلب تكوين مستخدم قاعدة بيانات لديه الوصول للكائنات المحددة التي تريد تحليلها وتحديد بيانات صلاحية المستخدم عند تكوين اتصال قاعدة البيانات.
إذا كنت تتصل بقاعدة بيانات Oracle، أو Oracle Autonomous Data Warehouse، أوOracle Transaction Processing، أو Snowflake، أو SQL Server، أو My SQL، يمكنك تغيير معرف الاقتباس الافتراضي لتتمكن من قراءة البيانات التي تحتوي على أحرف كبيرة، أو صغيرة، أو كبيرة وصغيرة في الجدول أو أسماء الأعمدة.
select "EfG_Field" from "AbCd";
بدلاً من إصدار select EfG_Field from AbCd;
, (الذي سيفشل).يمكنك استخدام Oracle Analytics Cloud REST API لإدارة الاتصالات بمجموعة من مصادر البيانات باستخدام البرامج. على سبيل المثال، قد تريد تكوين اسكربت يقوم بتكوين (أو تعديل) مجموعة الاتصالات نفسها في كل من بيئتي اختبار Oracle Analytics Cloud والإنتاج.
يمكنك تكوين الاتصالات لمجموعة مصادر بيانات وتحديثها وحذفها باستخدام REST API. يتناول هذا الموضوع أنواع اتصالات مصادر البيانات التي يمكنك إدارتها باستخدام واجهات REST API.
ملاحظة:
يقدم REST API for Oracle Analytics Cloud معلومات مفصلة حول كل REST API. يرجى الاطلاع على نقاط نهاية REST للاتصال.مصادر البيانات المدعومة
معلمات الاتصال
تختلف معلمات الاتصال المطلوبة لكل مصدر بيانات. إذا كنت تريد استخدام واجهة REST API لتكوين اتصال أو تحديثه، يجب أن تعرف تنسيق حمولة JSON المطلوب لمصدر بياناتك. يرجى الاطلاع على عينة من حمولات JSON لمصادر البيانات.
فيما يلي المهام الشائعة لبدء استخدام Oracle Analytics Cloud REST API لإدارة الاتصالات باستخدام البرامج. إذا كنت تستخدم واجهات REST API لأول مرة، فاتبع هذه المهام كدليل.
المهمة | الوصف | وثائق REST API |
---|---|---|
فهم المقررات الإلزامية |
فهم مهام المقررات الإلزامية العديدة وإتمامها. يجب أن يكون لديك أذونات لتكوين المصنفات والاتصال بالبيانات في Oracle Analytics Cloud لإدارة اتصالات البيانات باستخدام واجهات REST API (مؤلف محتوى DV). |
المتطلبات الأساسية |
فهم تصديق رمز OAuth 2.0 المميز | تتم إدارة التصديق والصلاحية في Oracle Analytics Cloud من خلال خدمة Oracle Identity Cloud Service. للوصول إلى REST APIs في Oracle Analytics Cloud، ستحتاج إلى الوصول إلى رمز وصول OAuth 2.0 المميز لتستخدمه للتصديق. | تصديق رمز OAuth 2.0 المميز |
فهم مصادر البيانات المدعومة | قراءة الموضوع الذي يصف أنواع اتصالات البيانات التي يمكنك إدارتها باستخدام واجهات REST API. | مصادر البيانات المدعومة |
تحديد تنسيقات حمولة JSON | قراءة الموضوع الذي يصف تنسيق حمولة JSON لمصدر بياناتك والحصول على معلمات الاتصال اللازمة. | عينة من حمولات JSON لمصادر البيانات |
تكوين اتصال | تكوين اتصال بيانات للاستخدام في المصنفات والتقارير ولوحات المعلومات. | تكوين اتصال (معاينة) |
تحديث اتصال | تحديث خاصية واحدة أو أكثر لاتصال بيانات موجود. | تحديث اتصال (معاينة) |
حذف اتصال | حذف اتصال بيانات. | حذف اتصال (معاينة) |
استخدم هذه العينات والأمثلة لمساعدتك على إدارة اتصالات مصادر البيانات بطلبات REST API باستخدام cURL.
تنسيق cURL للعينة
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --data "<data source connection payload>"
curl --header "Authorization: Bearer <token>" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --form "cert=<security wallet file>" --form "connectionParams=<data source connection payload>"
<token> - يتطلب OAuth 2.0 الرمز المميز للحامل لمصادقة الاستدعاءات لواجهات Oracle Analytics Cloud REST API. يرجى الاطلاع على تصديق رمز OAuth 2.0 المميز.
<hostname> - المضيف حيث Oracle Analytics Cloud قيد التشغيل.
<data source connection payload> - معلومات اتصال محددة بمصدر البيانات. يرجى الاطلاع على عينة من حمولات JSON لمصادر البيانات.
<security wallet file> - تخزين المعلومات المرتبطة بـ SSL مثل المصادقة وبيانات اعتماد التوقيع والمفاتيح الخاصة والشهادات والشهادات الموثوق بها. مطلوب لبعض أنواع الاتصال، مثل Oracle Database مع SSL وOracle Autonomous Data Warehouse (TLS المتبادل).
أمثلة
تعرض الأمثلة التالية كيفية تكوين اتصال بـ Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(TLS متبادل)ملاحظة:
حمولات JSON في هذه الأمثلة محددة في Oracle ADW. يختلف تنسيق حمولة JSON عن مصادر البيانات الأخرى. يرجى الاطلاع على حمولات JSON للعينة لمصادر البيانات المدعومة.المثال 1، تكوين اتصال (TLS) بدون حافظة بـ Oracle ADW
oracle_adw_walletless
. يتضمن نص الطلب JSON للعينة application/json
.
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST https://example.com/api/20210901/catalog/connections --data "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless", "description": "عينة اتصال Oracle ADW بدون حافظة تم تكوينه باستخدام واجهة API للاتصالات"، "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_adwwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } }"
نص الاستجابة
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
لاحظ connectionId
المشفر باستخدام Base64 في نص الاستجابة. لاحقًا، يمكنك استخدام هذه القيمة لتحديث الاتصال أو حذفه.
المثال 2 قم بتكوين اتصال Oracle ADW يستخدم ملف حافظة (TLS متبادلاً)
oracle_adw_with_wallet
. يتضمن نص الطلب multipart/form-data
, أي، يتطلب ملف حافظة من Oracle ADW (cwallet.sso
) ومعلمات اتصال Oracle ADW.
curl --header "الصلاحية: حامل <token>" -–request POST https://<hostname>/api/20210901/catalog/connections --form "cert=@"/Users/scott/Downloads/Wallet_adw/cwallet.sso"" --form "connectionParams= "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "عينة اتصال Oracle ADW مع حافظة تم تكوينه باستخدام واجهة API للاتصالات"، "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_walletadw_high.adwc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } }"
نص الاستجابة
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
لاحظ connectionId
المشفر باستخدام Base64 في نص الاستجابة. لاحقًا، يمكنك استخدام هذه القيمة لتحديث الاتصال أو حذفه.
تتوفر أمثلة إضافية في REST API for Oracle Analytics Cloud. يرجى الاطلاع على تكوين اتصال تحديث اتصال وحذف اتصال.
للاتصال بمصدر البيانات، يجب عليك توفير معلمات الاتصال. عند استخدام Connections REST API، فإنك تحدد معلمات الاتصال بتنسيق حمولة JSON. استخدم هذا الجدول لتحديد حمولة JSON لمصدر البيانات الذي تريد الاتصال به.
مصدر البيانات | نوع الطلب | حمولة الإدخال |
---|---|---|
Oracle Database (غير SSL) |
تطبيق/json |
نوع الاتصال الأساسي { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_basic", "description": "Sample non-SSL Oracle Database connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "1521", "serviceName": "orcl", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } نوع الاتصال المتقدم { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_advanced ", "description": " Sample non-SSL Oracle Database connection created with the advanced connection string format using Connections API", "content": { "connectionParams": { "connectionString": "(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=example.com)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))", "username": "admin", "password": "<password>", "connectionType": "oracle-database", "remoteData": false, "systemConnection": false } } } |
Oracle Database مع SSL |
بيانات النموذج/متعددة الأجزاء |
cwallet.sso (client credentials file) نوع الاتصال الأساسي cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_db_ssl", "description": "Sample Oracle Database connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "2484", "serviceName": "ORCLPDB1", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false } } } |
Oracle Autonomous Data Warehouse - بدون حافظة (TLS) |
تطبيق/json |
نوع الاتصال الأساسي { "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless_basic", "description": "Sample Oracle ADW connection without a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521) (host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } } |
Oracle Autonomous Data Warehouse - حافظة (TLS متبادلاً) |
بيانات النموذج/متعددة الأجزاء |
cwallet.sso (client credentials file) نوع الاتصال الأساسي cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Sample Oracle ADW connection with wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } } |
PostgreSQL (غير SSL) |
تطبيق/json |
نوع الاتصال الأساسي { "version":"2.0.0", "type": "connection", "name": "postgres_non_SSL", "description": "Sample PostgreSQL connection created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
PostgreSQL مع SSL |
تطبيق/json |
نوع الاتصال الأساسي { "version":"2.0.0", "type": "connection", "name": "postgres_SSL_Conn", "description": "Sample PostgreSQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
خادم SQL Server (غير SSL) |
تطبيق/json |
نوع الاتصال الأساسي { "version":"2.0.0", "type": "connection", "name": "SqlServer_non_ssl", "description": "Sample non-SSL SQL Server connection created using Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "1400", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
خادم SQL Server مع SSL | تطبيق/json |
نوع الاتصال الأساسي { "version":"2.0.0", "type": "connection", "name": "SqlServer_ssl", "description": "Sample SQL Server connection with SSL created using the Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "60190", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
MySQL (غير SSL) |
تطبيق/json |
نوع الاتصال الأساسي { "version":"2.0.0", "type": "connection", "name": "MySql_no_SSL", "description": "Sample MySQL connection created using the Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3307", "serviceName": "mysql1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
MySQL مع SSL | تطبيق/json |
نوع الاتصال الأساسي { "version":"2.0.0", "type": "connection", "name": "MySql_ssl", "description": "Sample MySQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3306", "serviceName": "mysql1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
Oracle Essbase |
تطبيق/json |
نوع الاتصال الأساسي { "version":"2.0.0", "type": "connection", "name": "Oracle_Essbase", "description": "Sample Oracle Essbase connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-essbase", "dsn":"example.com", "username":"admin", "password":"<password>", "remoteData": false, "systemConnection": false, "authentication":"current"/"private"/"sso" } } } |