คุณสามารถสร้าง อัปเดต ลบ และใช้การเชื่อมโยงไปยังที่มาข้อมูลร่วมกัน ในฐานะผู้ใช้ 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)ตัวอย่างเพิ่มเติมมีอยู่ใน REST API สำหรับ Oracle Analytics Cloud โปรดดู สร้างการเชื่อมต่อ (ตัวอย่าง), อัปเดตการเชื่อมต่อ (ตัวอย่าง) และ ลบการเชื่อมต่อ (ตัวอย่าง)
หมายเหตุ:
เพย์โหลด 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 การเชื่อมต่อ คุณต้องระบุพารามิเตอร์การเชื่อมต่อในรูปแบบเพย์โหลด 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" } } } |