หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ตัวแปรอ้างอิงการเชื่อมต่อเป็นตัวแปรพื้นที่ทํางานที่เก็บรหัสของ การเชื่อมต่อข้อมูลภายนอก (ตัวอย่างเช่น Snowflake, Azure SQL) ซึ่งอนุญาตให้รายการอ้างอิงทรัพยากรภายนอกโดยไม่ต้องฝังข้อมูลประจําตัวหรือสตริงการเชื่อมต่อ
วิธีใช้
ตัวแปรอ้างอิงการเชื่อมต่อสามารถใช้ได้เหมือนกับตัวแปรอื่นๆ ในไลบรารีตัวแปร
- ลงชื่อเข้าใช้ Microsoft Fabric
- นําทางไปยังพื้นที่ทํางานและไลบรารีตัวแปรของคุณ
- ที่ด้านบน ให้เลือก + ตัวแปรใหม่
- ระบุชื่อสําหรับตัวแปร เลือก การอ้างอิงการเชื่อมต่อ สําหรับชนิด แล้วคลิก ... เพื่อเลือกค่า
5. เมื่อเลือกแล้ว การอ้างอิงการเชื่อมต่อของคุณควรพร้อมใช้งาน
หากคุณต้องการแก้ไขการอ้างอิงการเชื่อมต่อหรือต้องการตรวจสอบค่าอีกครั้งคุณสามารถคลิกขวาที่ค่าเพื่อเปิดป๊อปอัปพร้อมข้อมูลเกี่ยวกับการอ้างอิงการเชื่อมต่อ
วิธีการทำงาน
ค่าของตัวแปรอ้างอิงการเชื่อมต่อเป็นตัวชี้แบบคงที่ไปยังออบเจ็กต์การเชื่อมต่อที่ระบุโดย ID การเชื่อมต่อ ค่าจะถูกเก็บไว้เป็นสตริงที่สอดคล้องกับ ID ของการเชื่อมต่อเป้าหมาย เช่น:
รหัสการเชื่อมต่อ = aaaaa-0000-1111-2222-bbbbbbbbbbbbbb
รหัสนี้ระบุการเชื่อมต่อที่อ้างอิงโดยไม่ซ้ํากัน การอ้างอิงแบบคงที่จะไม่ปรับให้เข้ากับสภาพแวดล้อมการปรับใช้ที่แตกต่างกันโดยอัตโนมัติ กําหนดให้มีการเชื่อมต่อเป้าหมาย ณ เวลาที่เลือก และยังคงชี้ไปที่การเชื่อมต่อเฉพาะนั้น เว้นแต่จะเปลี่ยนแปลงด้วยตนเอง
โปรดคํานึงถึงสิ่งต่อไปนี้เมื่อทํางานกับการอ้างอิงการเชื่อมต่อ:
- จัดเก็บตัวระบุการเชื่อมต่อที่กําหนดไว้ล่วงหน้าที่ระดับผู้เช่า
- การอ้างอิงการเชื่อมต่อจะไม่ผูกอัตโนมัติระหว่างการปรับใช้ ค่าของพวกเขายังคงคงที่ในสภาพแวดล้อมต่างๆ
- รองรับ CI/CD และระบบอัตโนมัติโดยการกําหนดพารามิเตอร์การเชื่อมต่อภายนอกสําหรับสภาพแวดล้อมที่แตกต่างกัน (dev, test, prod)
- เปิดใช้งานการกําหนดค่าแบบไดนามิกของความสัมพันธ์ภายนอก (ตัวอย่างเช่น การสลับแหล่งข้อมูลหรือข้อมูลประจําตัวต่อสภาพแวดล้อม)
- ค่าจะถูกเลือกผ่านกล่องโต้ตอบ UI ไม่ใช่ข้อความอิสระ เพื่อให้มั่นใจว่าสามารถเลือกได้เฉพาะการเชื่อมต่อที่ได้รับอนุญาตเท่านั้น
- เฉพาะการเชื่อมต่อที่มีสิทธิ์ในการอ่านเป็นอย่างน้อยเท่านั้นที่สามารถเลือกได้
การเป็นตัวแทนใน Git และ API
การอ้างอิงการเชื่อมต่อเป็นชนิดตัวแปรขั้นสูงที่มี Schema ค่าเก็บ connectionId (และแพลตฟอร์มแก้ไข/แสดงข้อมูลเมตา) เพย์โหลดการเขียนประกอบด้วย:
- name: displayName ของตัวแปรอ้างอิงการเชื่อมต่อ
- หมายเหตุ: ไม่บังคับสามารถใช้สําหรับคําอธิบายหรือบันทึกอื่น ๆ
- type: "connectionReference" (ชนิดขั้นสูง)
- value: ต่อชุดค่า แต่ละค่าจะเก็บ { "connectionId": "<สตริง> GUID/ID" }
ตัวอย่าง:
{
"name": "PrimaryDb",
"note": "",
"type": "connectionReference",
"value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
}
สิทธิ์ที่จําเป็นในการสร้าง/ใช้การอ้างอิงการเชื่อมต่อ
การใช้ตัวแปรอ้างอิงการเชื่อมต่อเกี่ยวข้องกับสิทธิ์สองชั้น:
- สร้างและแก้ไขตัวแปรอ้างอิงการเชื่อมต่อ: ผู้ใช้ที่มีบทบาทผู้สนับสนุนหรือสูงกว่าในพื้นที่ทํางานสามารถสร้างและแก้ไขตัวแปรในไลบรารีได้
- การเข้าถึงตัวแปรอ้างอิงการเชื่อมต่อ: นอกเหนือจากสิทธิ์ในไลบรารีตัวแปรแล้ว คุณต้องมีสิทธิ์อ่านอย่างน้อยในตัวแปรอ้างอิงการเชื่อมต่อที่คุณต้องการอ้างอิง
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับสิทธิ์และการตรวจสอบสิทธิ์ ให้ดูที่ สิทธิ์ของไลบรารีตัวแปร
รายการที่สนับสนุน
ต่อไปนี้เป็นรายการของรายการที่สนับสนุนตัวแปรอ้างอิงการเชื่อมต่อ:
- โน๊ตบุ๊คผ่าน NotebookUtils
- ฟังก์ชันข้อมูลผู้ใช้
ตัวอย่างโค้ด Python
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้การอ้างอิงการเชื่อมต่อในสคริปต์ python
var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)
รหัสนี้มีดังต่อไปนี้:
- แก้ไขตัวแปรอ้างอิงการเชื่อมต่อจากไลบรารีตัวแปร Fabric
- ดึงข้อมูลเมตาของอ็อบเจ็กต์การเชื่อมต่อ
- แยก connectionId
- พิมพ์ ID เพื่อให้สามารถใช้ในการเรียกใช้โค้ดหรือการเรียก API ได้
ข้อจำกัด
ข้อจํากัดต่อไปนี้ใช้กับตัวแปรอ้างอิงการเชื่อมต่อ:
- การเชื่อมต่อในตัวในสมุดบันทึกไม่ได้รับการสนับสนุนเนื่องจาก connection_id สําหรับการเชื่อมต่อสมุดบันทึกไม่เหมือนกัน