จัดการการเชื่อมต่อกับที่มาข้อมูล

คุณสามารถสร้าง อัปเดต ลบ และใช้การเชื่อมโยงไปยังที่มาข้อมูลร่วมกัน ในฐานะผู้ใช้ Oracle Analytics ที่มีสิทธิ์เข้าใช้ของผู้สร้างเนื้อหา DV คุณสามารถใช้การดำเนินการเหล่านี้

หัวข้อต่างๆ มีดังนี้

สร้างการเชื่อมต่อกับที่มาข้อมูล

คุณสามารถสร้างการเชื่อมต่อเพื่อช่วยให้วิเคราะห์ข้อมูลในที่มาข้อมูลนั้นได้

  1. ที่เพจ โฮม คลิก สร้าง แล้วคลิก การเชื่อมต่อ
  2. ในกล่องไดอะล็อก เลือกประเภทการเชื่อมต่อ ให้คลิกไอคอนสำหรับประเภทการเชื่อมต่อที่คุณต้องการ ตัวอย่างเช่น Oracle Database
  3. ป้อนข้อมูลการเชื่อมต่อที่ต้องระบุ เช่น โฮสต์ พอร์ต ชื่อผู้ใช้ รหัสผ่าน และชื่อบริการ
  4. ทางเลือก: เลือกตัวเลือก การตรวจสอบสิทธิ์ สำหรับการเชื่อมต่อของคุณ
    • ใช้ชื่อผู้ใช้และรหัสผ่านเหล่านี้ทุกครั้ง - Oracle Analytics จะใช้ชื่อล็อกอินและรหัสผ่านที่คุณระบุสำหรับการเชื่อมต่อนี้ทุกครั้ง ระบบไม่แสดงพรอมต์ให้ผู้ใช้ล็อกอิน
    • ผู้ใช้ต้องป้อนชื่อผู้ใช้และรหัสผ่านของตนเอง - Oracle Analytics แสดงพรอมต์ให้ผู้ใช้ป้อนชื่อผู้ใช้และรหัสผ่านของตนเองสำหรับที่มาข้อมูล ผู้ใช้สามารถเข้าใช้เฉพาะข้อมูลที่ได้รับอนุญาต มีสิทธิ์ และได้รับการระบุบทบาทเท่านั้น
    • (แสดงในกรณีที่ Oracle Analytics รองรับการดำเนินการเป็นบุคคลอื่นสำหรับฐานข้อมูลประเภทนี้) ใช้ชื่อผู้ใช้และรหัสผ่านของผู้ใช้ที่ใช้งาน - Oracle Analytics ไม่แสดงพรอมต์ให้ผู้ใช้เข้าสู่ระบบเพื่อเข้าใช้ข้อมูล ชื่อผู้ใช้และรหัสผ่านเดียวกันกับที่ใช้เข้าสู่ระบบ Oracle Analytics จะใช้เพื่อเข้าใช้ที่มาข้อมูลนี้ด้วย
  5. หากคุณกำลังเชื่อมต่อกับฐานข้อมูลระยะไกล ให้คลิก ใช้การเชื่อมต่อข้อมูลระยะไกล
    ตรวจสอบกับผู้ดูแลระบบว่าคุณเข้าใช้ฐานข้อมูลระยะไกลได้หรือไม่
  6. หากคุณต้องการใช้รายละเอียดการเชื่อมต่อเหล่านี้ใน Semantic Modeler หรือ Model Administration Tool ให้คลิก การเชื่อมต่อระบบ โปรดดู ตัวเลือกการเชื่อมต่อฐานข้อมูล
  7. คลิก บันทึก
    ตอนนี้ คุณก็เริ่มสร้างเวิร์กบุคหรือชุดข้อมูลโดยใช้การเชื่อมต่อนี้ได้แล้ว ตัวอย่างเช่น จาก โฮมเพจ ให้คลิก สร้าง แล้วคลิก ชุดข้อมูล จากนั้นเลือกการเชื่อมต่อที่คุณเพิ่งสร้าง

แก้ไขการเชื่อมต่อกับที่มาข้อมูล

คุณสามารถอัปเดตรายละเอียดการเชื่อมต่อของที่มาข้อมูล

ถ้าคุณแก้ไขการเชื่อมต่อ SSL ไปยัง Oracle Database และคุณต้องใช้ไฟล์ cwallet.sso ใหม่ ในฟิลด์ วอลเล็ตของไคลเอนต์ ให้คลิก เลือก เพื่อเบราส์ไฟล์ cwallet.sso สอบถามที่ตั้งของไฟล์ cwallet.sso จากผู้ดูแลระบบของคุณ

  1. ในโฮมเพจ ให้คลิกนาวิเกเตอร์ แล้วเลือก ข้อมูล จากนั้นคลิก การเชื่อมต่อ
  2. วางเคอร์เซอร์เหนือการเชื่อมต่อที่คุณต้องการแก้ไข ทางด้านขวาของการเชื่อมต่อที่ไฮไลต์ ให้คลิก การดำเนินการ และเลือก ตรวจสอบ
  3. ในไดอะล็อก ตรวจสอบ ให้แก้ไขรายละเอียดการเชื่อมต่อ
    คุณไม่สามารถดูรหัสผ่านปัจจุบันหรือ SQL แบบลอจิคัลสำหรับการเชื่อมต่อของคุณได้ หากคุณต้องแก้ไข ให้สร้างการเชื่อมต่อใหม่
  4. คลิก บันทึก

ลบการการเชื่อมต่อกับที่มาข้อมูล

คุณสามารถย้ายการการเชื่อมต่อที่มาข้อมูลออกจาก Oracle Analytics Cloud ได้ ตัวอย่างเช่น คุณต้องลบการเชื่อมต่อฐานข้อมูลและสร้างการเชื่อมต่อใหม่เมื่อมีการเปลี่ยนรหัสผ่านของฐานข้อมูล

หากการเชื่อมต่อมีชุดข้อมูลใดๆ คุณต้องลบชุดข้อมูลนั้นก่อนจึงจะสามารถลบการเชื่อมต่อนั้นได้

  1. ไปที่เพจ ข้อมูล และเลือก การเชื่อมต่อ
  2. วางเคอร์เซอร์เหนือการเชื่อมต่อที่คุณต้องการลบ ทางด้านขวาของการเชื่อมต่อที่ไฮไลต์ ให้คลิก การดำเนินการ และเลือก ลบ
  3. คลิก ใช่

ใช้การเชื่อมต่อที่มาข้อมูลร่วมกัน

คุณสามารถระบุสิทธิ์การเข้าใช้การเชื่อมต่อที่มาข้อมูลที่คุณสร้างหรือจัดการ

  1. ใน โฮมเพจ ให้คลิก นาวิเกเตอร์ คลิก ข้อมูล แล้วคลิก การเชื่อมต่อ
  2. วางเคอร์เซอร์เหนือการเชื่อมต่อที่คุณต้องการใช้ร่วมกัน คลิก การดำเนินการ แล้วเลือก ตรวจสอบ
  3. คลิก การเข้าใช้ และใช้แท็บเพื่อให้สิทธิ์เข้าใช้:
    • ทั้งหมด - ใช้การเชื่อมต่อร่วมกับผู้ใช้หรือบทบาทแต่ละรายการ

    • ผู้ใช้ - ใช้การเชื่อมต่อร่วมกับผู้ใช้แต่ละราย

    • บทบาท - ใช้การเชื่อมต่อร่วมกับบทบาทของแอปพลิเคชัน (เช่น BI Consumer) เพื่อให้ผู้ใช้ทั้งหมดที่มีบทบาทเหล่านั้นสามารถใช้การเชื่อมต่อได้

  4. ใช้ช่อง เพิ่ม เพื่อค้นหาและเลือกผู้ใช้หรือบทบาท
    ผู้ใช้หรือบทบาทจะแสดงในลิสต์ด้านล่างพร้อมสิทธิ์ดีฟอลต์ อ่านอย่างเดียว
  5. ในการเปลี่ยนสิทธิ์ดีฟอลต์ ให้เลือกรายการใดรายการหนึ่งต่อไปนี้
    • มีสิทธิ์เต็ม - ผู้ใช้หรือบทบาทสามารถใช้การเชื่อมต่อเพื่อสร้างชุดข้อมูล หรือแก้ไข เปลี่ยนชื่อ หรือลบการเชื่อมต่อได้ นอกจากนี้ยังสามารถเปลี่ยนแปลงสิทธิ์สำหรับการเชื่อมต่อ
    • อ่าน-เขียน - ผู้ใช้หรือบทบาทสามารถใช้การเชื่อมต่อเพื่อสร้างชุดข้อมูล และแก้ไขหรือเปลี่ยนชื่อการเชื่อมต่อ (แต่ไม่สามารถลบ)
    • อ่านอย่างเดียว - ผู้ใช้หรือบทบาทสามารถใช้การเชื่อมต่อเพื่อสร้างชุดข้อมูล แต่ไม่สามารถเปลี่ยนแปลงรายละเอียดการเชื่อมต่อ
  6. คลิก บันทึก
เมื่อผู้ใช้ล็อกอินในครั้งต่อไป ผู้ใช้จะสามารถใช้การเชื่อมต่อที่คุณใช้ร่วมกันไว้เพื่อแสดงข้อมูลจากฐานข้อมูลนี้ได้

ตัวเลือกการเชื่อมต่อฐานข้อมูล

เมื่อคุณระบุรายละเอียดการเชื่อมต่อโดยใช้ไดอะล็อก สร้างการเชื่อมต่อหรือตรวจสอบ ฐานข้อมูลบางประเภทจะมีตัวเลือกคอนฟิเกอเรชันเพิ่มเติม

ตัวเลือกทั่วไป

  • เมื่อคุณสร้างการเชื่อมต่อกับ Oracle Database คุณสามารถเชื่อมต่อได้ด้วยสองวิธีโดยใช้ตัวเลือก ประเภทการเชื่อมต่อ:
    • พื้นฐาน - ระบุ โฮสต์, พอร์ต และ ชื่อบริการ ของฐานข้อมูล
    • ขั้นสูง - ในฟิลด์ สตริงการเชื่อมต่อ ให้ระบุ Single Client Access Name (SCAN) ID ของฐานข้อมูลที่รันในคลัสเตอร์ RAC ตัวอย่างเช่น

      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)))

  • ใช้งานการจำลองข้อมูลเป็นกลุ่ม - หากคุณโหลดชุดข้อมูลสำหรับเวิร์กบุค ควรปิดตัวเลือกนี้ และคุณสามารถละเว้น ตัวเลือกนี้สงวนไว้สำหรับนักวิเคราะห์ข้อมูลและผู้ใช้ขั้นสูงสำหรับการจำลองข้อมูลจากฐานข้อมูลหนึ่งไปยังอีกฐานข้อมูลหนึ่ง

ตัวเลือกการตรวจสอบสิทธิ์

  • ใช้ชื่อผู้ใช้และรหัสผ่านเหล่านี้ทุกครั้ง - Oracle Analytics จะใช้ชื่อล็อกอินและรหัสผ่านที่คุณระบุสำหรับการเชื่อมต่อนี้ทุกครั้ง ระบบไม่แสดงพรอมต์ให้ผู้ใช้ล็อกอิน
  • ผู้ใช้ต้องป้อนชื่อผู้ใช้และรหัสผ่านของตนเอง - Oracle Analytics แสดงพรอมต์ให้ผู้ใช้ป้อนชื่อผู้ใช้และรหัสผ่านของตนเองสำหรับที่มาข้อมูล ผู้ใช้สามารถเข้าใช้เฉพาะข้อมูลที่ได้รับอนุญาต มีสิทธิ์ และได้รับการระบุบทบาทเท่านั้น
  • (แสดงในกรณีที่ Oracle Analytics รองรับการดำเนินการเป็นบุคคลอื่นสำหรับฐานข้อมูลประเภทนี้) ใช้ชื่อผู้ใช้และรหัสผ่านของผู้ใช้ที่ใช้งาน - Oracle Analytics ไม่แสดงพรอมต์ให้ผู้ใช้เข้าสู่ระบบเพื่อเข้าใช้ข้อมูล ชื่อผู้ใช้และรหัสผ่านเดียวกันกับที่ใช้เข้าสู่ระบบ Oracle Analytics จะใช้เพื่อเข้าใช้ที่มาข้อมูลนี้ด้วย

การเชื่อมต่อ

คลิก คัดลอก เพื่อคัดลอก 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 คุณสามารถเปลี่ยนตัวระบุเครื่องหมายคำพูดดีฟอลต์ เพื่อให้คุณสามารถอ่านข้อมูลที่มีอักขระตัวพิมพ์ใหญ่ ตัวพิมพ์เล็ก และผสมกันในชื่อตารางหรือคอลัมน์ได้

ตัวอย่างเช่น คุณอาจเลือกเครื่องหมายคำพูดคู่เป็นตัวระบุเครื่องหมายคำพูด จากนั้น Oracle Analytics จะเพิ่มเครื่องหมายคำพูดคู่ไปยังคำสั่ง SQL select "EfG_Field" from "AbCd"; แทนที่จะออก select EfG_Field from AbCd; (ซึ่งอาจไม่สำเร็จ)
  1. ที่เพจ โฮม คลิก สร้าง แล้วคลิก การเชื่อมต่อ
  2. คลิกที่หนึ่งในประเภทฐานข้อมูลที่รองรับคุณสมบัติขั้นสูง
    ฐานข้อมูลที่รองรับได้แก่ Oracle, Oracle Autonomous Data Warehouse, Snowflake และ My SQL
  3. ระบุรายละเอียดการเชื่อมต่อ แล้วบันทึกการเชื่อมต่อ
  4. ในโฮมเพจ ให้คลิก นาวิเกเตอร์ แล้วคลิก ข้อมูล จากนั้นคลิก การเชื่อมต่อ
  5. วางเคอร์เซอร์เหนือการเชื่อมต่อที่คุณต้องการบันทึกในขั้นตอนที่ 2 และคลิก การดำเนินการ แล้วคลิก ตรวจสอบ
  6. คลิก ขั้นสูง แล้วใช้ตัวเลือกตัวระบุเครื่องหมายคำพูดเพื่อเลือกตัวระบุเครื่องหมายคำพูดที่ใช้ในฐานข้อมูล

    ตัวอย่างเช่น คุณอาจเลือก เครื่องหมายคำพูดคู่ (" ") จากนั้น Oracle Analytics จะเพิ่มเครื่องหมายคำพูดคู่ไปยังคำสั่ง SQL เลือก "EfG_Field" จาก "AbCd"; แทนที่จะออก เลือก EfG_Field จาก AbCd;

    หมายเหตุ:

    คุณจะไม่เห็นตัวเลือก ขั้นสูง หากมีการสร้างการเชื่อมต่อโดยเลือกตัวเลือก การเชื่อมต่อระบบ ไว้ การเชื่อมต่อระบบไม่รองรับตัวเลือกขั้นสูง
  7. คลิก บันทึก

จัดการการเชื่อมต่อโดยใช้ REST API

คุณสามารถใช้ Oracle Analytics Cloud REST API เพื่อจัดการการเชื่อมต่อแบบเป็นโปรแกรมกับช่วงที่มาข้อมูล ตัวอย่างเช่น คุณอาจต้องการสร้างสคริปต์ที่สร้าง (หรือแก้ไข) การเชื่อมต่อชุดเดียวกันใน Oracle Analytics Cloud ทั้งสภาพแวดล้อมการทดสอบและการใช้งานจริง

ข้อมูลเกี่ยวกับ REST API ของการเชื่อมต่อ

คุณสามารถสร้าง อัปเดต และลบการเชื่อมต่อสำหรับช่วงที่มาข้อมูลโดยใช้ REST API หัวข้อนี้จะแสดงลิสต์ประเภทการเชื่อมต่อที่มาข้อมูลที่คุณสามารถจัดการด้วย REST API ได้

หมายเหตุ:

REST API สำหรับ Oracle Analytics Cloud แสดงข้อมูลโดยละเอียดเกี่ยวกับ REST API แต่ละรายการ โปรดดู จุดสิ้นสุด REST ของการเชื่อมต่อ

ที่มาข้อมูลที่รองรับ

  • Oracle Database
  • Oracle Autonomous Data Warehouse
  • Oracle Essbase
  • MySQL
  • PostgreSQL
  • Snowflake
  • SQL Server
  • Vertica

พารามิเตอร์การเชื่อมต่อ

พารามิเตอร์การเชื่อมต่อที่จำเป็นสำหรับที่มาข้อมูลแต่ละรายการจะแตกต่างกันไป หากคุณต้องการใช้ REST API เพื่อสร้างหรืออัปเดตการเชื่อมต่อ คุณต้องทราบถึงรูปแบบเพย์โหลด JSON ที่จำเป็นสำหรับที่มาข้อมูลของคุณ โปรดดู ตัวอย่างเพย์โหลด JSON สำหรับที่มาข้อมูล

เวิร์กโฟลว์ทั่วไปสำหรับการจัดการการเชื่อมต่อโดยใช้ REST API

ต่อไปนี้เป็นงานทั่วไปที่จะเริ่มต้นโดยใช้ 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 เพื่อจัดการการเชื่อมต่อที่มาข้อมูล

ใช้ตัวอย่างเหล่านี้เพื่อช่วยให้คุณจัดการการเชื่อมต่อที่มาข้อมูลกับคำขอ REST API โดยใช้ cURL

ตัวอย่างรูปแบบ cURL

ใช้รูปแบบคำสั่ง cURL ต่อไปนี้เพื่อสร้างหรืออัปเดตการเชื่อมต่อที่มาข้อมูลโดยใช้ REST API:
  • JSON แบบง่าย
    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)

  • ตัวอย่างที่ 1 - สร้างการเชื่อมต่อแบบไร้วอลเล็ต (TLS) กับ Oracle ADW
  • ตัวอย่างที่ 2 - สร้างการเชื่อมต่อกับ Oracle 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 ในเนื้อหาการตอบกลับ คุณสามารถใช้ค่านี้เพื่ออัปเดตหรือลบการเชื่อมต่อในภายหลัง

ตัวอย่างเพย์โหลด JSON สำหรับที่มาข้อมูล

หากต้องการเชื่อมต่อกับที่มาข้อมูล คุณต้องระบุพารามิเตอร์การเชื่อมต่อ เมื่อคุณใช้ 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"
    }
  }
}