คุณสามารถสร้าง อัปเดต ลบ และใช้การเชื่อมโยงไปยังที่มาข้อมูลร่วมกัน ในฐานะผู้ใช้ 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"
}
}
} |