คุณสามารถสร้าง อัปเดต ลบ และใช้การเชื่อมโยงไปยังที่มาข้อมูลร่วมกัน ในฐานะผู้ใช้ Oracle Analytics ที่มีสิทธิ์เข้าใช้ของผู้สร้างเนื้อหา DV คุณสามารถใช้การดำเนินการเหล่านี้
หัวข้อต่างๆ มีดังนี้
คุณสามารถสร้างการเชื่อมต่อเพื่อช่วยให้วิเคราะห์ข้อมูลในที่มาข้อมูลนั้นได้
คุณสามารถอัปเดตรายละเอียดการเชื่อมต่อของที่มาข้อมูล
ถ้าคุณแก้ไขการเชื่อมต่อ SSL ไปยัง Oracle Database และคุณต้องใช้ไฟล์ 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)))
ใช้งานการจำลองข้อมูลเป็นกลุ่ม - หากคุณโหลดชุดข้อมูลสำหรับเวิร์กบุค ควรปิดตัวเลือกนี้ และคุณสามารถละเว้น ตัวเลือกนี้สงวนไว้สำหรับนักวิเคราะห์ข้อมูลและผู้ใช้ขั้นสูงสำหรับการจำลองข้อมูลจากฐานข้อมูลหนึ่งไปยังอีกฐานข้อมูลหนึ่ง
ตัวเลือกการตรวจสอบสิทธิ์
การเชื่อมต่อ
คลิก คัดลอก เพื่อคัดลอก ID ออบเจกต์ ของการเชื่อมต่อ ผู้สร้างโมเดลธุรกิจสามารถวาง ID ออบเจกต์ เพื่อระบุและใช้การเชื่อมต่อข้อมูลใน Model Administration Tool (ไดอะล็อกพูลการเชื่อมต่อ)
หมายเหตุ: หากคุณไม่ได้คลิก การเชื่อมต่อระบบ เมื่อสร้างการเชื่อมต่อในตอนแรก และภายหลังต้องการให้ Data Modeler ใช้รายละเอียดการเชื่อมต่อ คุณจะต้องสร้างการเชื่อมต่อใหม่และเลือก การเชื่อมต่อระบบ พูดอีกอย่างก็คือ คุณไม่สามารถแก้ไขการเชื่อมต่อในภายหลังและเลือกตัวเลือกนี้ได้
ทำความเข้าใจข้อกำหนดการเชื่อมต่อฐานข้อมูลของคุณก่อนที่จะสร้างการเชื่อมต่อฐานข้อมูล
จำนวนสูงสุดของตารางฐานข้อมูลที่แสดงใน Oracle Analytics คือ 10,000 ถ้าคุณต้องการตารางเพิ่มเติม Oracle แนะนำให้คุณขอให้ผู้ดูแลระบบฐานข้อมูลสร้างผู้ใช้ฐานข้อมูลที่มีสิทธิ์เข้าใช้ออบเจกต์ที่กำหนดที่คุณต้องการวิเคราะห์และระบุชื่อผู้ใช้และรหัสผ่านของผู้ใช้เมื่อคุณสร้างการเชื่อมต่อฐานข้อมูล
หากคุณกำลังเชื่อมต่อกับ Oracle Database, 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 สำหรับ 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 ในการเข้าใช้ Oracle Analytics Cloud REST API คุณต้องมีโทเค็นสิทธิ์เข้าใช้ 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 (Mutual TLS)
ตัวอย่าง
ตัวอย่างต่อไปนี้จะแสดงวิธีสร้างการเชื่อมต่อกับ Oracle Autonomous Data Warehouse (ADW)
cwallet.sso
(Mutual 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": "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=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=="}
จดบันทึก Base64 ที่เข้ารหัส connectionId
ในเนื้อหาการตอบกลับ คุณสามารถใช้ค่านี้เพื่ออัปเดตหรือลบการเชื่อมต่อในภายหลัง
ตัวอย่างที่ 2 สร้างการเชื่อมต่อกับ Oracle ADW ที่ใช้ไฟล์วอลเล็ต (Mutual TLS)
oracle_adw_with_wallet
เนื้อหาคำขอประกอบด้วย multipart/form-data
ซึ่งจำเป็นต้องมีทั้งไฟล์วอลเล็ตจาก Oracle ADW (cwallet.sso
) และพารามิเตอร์การเชื่อมต่อ Oracle ADW
curl --header "Authorization: Bearer <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": "Sample Oracle ADW connection with 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=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="}
จดบันทึก Base64 ที่เข้ารหัส connectionId
ในเนื้อหาการตอบกลับ คุณสามารถใช้ค่านี้เพื่ออัปเดตหรือลบการเชื่อมต่อในภายหลัง
ตัวอย่างเพิ่มเติมมีอยู่ใน REST API สำหรับ Oracle Analytics Cloud โปรดดู สร้างการเชื่อมต่อ, อัปเดตการเชื่อมต่อ และ ลบการเชื่อมต่อ
หากต้องการเชื่อมต่อกับที่มาข้อมูล คุณต้องระบุพารามิเตอร์การเชื่อมต่อ เมื่อคุณใช้ REST API การเชื่อมต่อ คุณต้องระบุพารามิเตอร์การเชื่อมต่อในรูปแบบเพย์โหลด JSON ใช้ตารางนี้เพื่อกำหนดเพย์โหลด JSON สำหรับที่มาข้อมูลที่คุณต้องการเชื่อมต่อ
ที่มาข้อมูล | ประเภทคำขอ | เพย์โหลดอินพุต |
---|---|---|
Oracle Database (ไม่ใช่ SSL) |
application/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 |
multi-part/form-data |
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) |
application/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 - วอลเล็ต (Mutual TLS) |
multipart/form-data |
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) |
application/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 |
application/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) |
application/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 | application/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) |
application/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 | application/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 |
application/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" } } } |