ชนิดตัวแปรอ้างอิงสินค้า (พรีวิว)

เพื่อเพิ่มความยืดหยุ่นและความสามารถในการปรับขนาด เราขอแนะนําตัวแปรขั้นสูงควบคู่ไปกับชนิดตัวแปรพื้นฐานที่มีอยู่ ตัวแปรขั้นสูงเหล่านี้ได้รับการออกแบบมาเพื่อตอบสนองความต้องการที่สําคัญ เช่น การกําหนดพารามิเตอร์การเชื่อมต่อภายนอกและภายใน (เช่น Snowflake, AWS, OneLake)

ตัวแปร อ้างอิงรายการ เป็นชนิดตัวแปรขั้นสูงที่ใช้ภายในไลบรารีตัวแปร Fabric เพื่อเก็บการอ้างอิงไปยังรายการ Fabric ที่มีอยู่ เช่น เลคเฮาส์ สมุดบันทึก หรือไปป์ไลน์ข้อมูล โดยการจัดเก็บรหัสพื้นที่ทํางานและรหัสรายการ ตัวแปรชนิดนี้เปิดใช้งานการกําหนดพารามิเตอร์การเชื่อมต่อภายใน ซึ่งช่วยให้นักพัฒนาสามารถเชื่อมโยงรายการไปยังรายการ Fabric เฉพาะแบบไดนามิกตามขั้นตอนการปรับใช้หรือบริบทของพื้นที่ทํางาน

วิธีใช้

ตัวแปรอ้างอิงรายการสามารถใช้ได้เหมือนกับตัวแปรอื่นๆ ในไลบรารีตัวแปร

1. ลงชื่อเข้าใช้ Microsoft Fabric
2. นําทางไปยังพื้นที่ทํางานและไลบรารีตัวแปรของคุณ
3. ที่ด้านบน ให้เลือก + ตัวแปรใหม่
4. ระบุชื่อสําหรับตัวแปร เลือก การอ้างอิงรายการ สําหรับชนิด แล้วคลิก ... เพื่อเลือกค่า
5. การดําเนินการนี้จะเปิดกล่องโต้ตอบเพื่อเลือกรายการที่ต้องการ คุณจะเห็นรายการทั้งหมดที่คุณมีสิทธิ์เลือกได้ ใช้ตัวสํารวจทางด้านซ้ายเพื่อกรองรายการตามพื้นที่ทํางาน ใช้ตัวกรองที่มุมขวาบนเพื่อกรองตามประเภท

6. เมื่อเลือกแล้วจะปรากฏในหน้าวาร์ลิบ - เป็นส่วนประกอบแบบอ่านอย่างเดียวที่แสดงชื่อของรายการ

หากคุณต้องการแก้ไขการอ้างอิงรายการหรือจําเป็นต้องตรวจสอบค่าอีกครั้ง:

• หากต้องการดูรายละเอียดเพิ่มเติม ให้คลิกค่า
• หากต้องการแก้ไขค่านี้หรือค่าของชุดค่าอื่นๆ ให้คลิกปุ่มถัดจากค่า

วิธีการทำงาน

ค่าของตัวแปรการอ้างอิงรายการเป็นตัวชี้แบบคงที่ไปยังรายการ Fabric ที่ระบุโดย Workspace ID + Item ID ค่าจะถูกเก็บไว้เป็นคู่ของ GUID ที่สอดคล้องกับพื้นที่ทํางานของรายการเป้าหมายและตัวรายการเอง ตัวอย่างเช่น การอ้างอิงอาจถูกจัดเก็บภายในเป็น:

• รหัสพื้นที่ทํางาน = aaaaa-0000-1111-2222-bbbbbbbbbbbbbb
• รหัสรายการ = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

รหัสทั้งสองนี้ร่วมกันระบุรายการที่อ้างอิงโดยไม่ซ้ํากัน

โปรดคํานึงถึงสิ่งต่อไปนี้เมื่อทํางานกับการอ้างอิงรายการ:

• การอ้างอิงรายการเปิดใช้งานการกําหนดพารามิเตอร์การเชื่อมต่อภายใน ซึ่งช่วยให้นักพัฒนาสามารถเชื่อมโยงรายการกับทรัพยากร Fabric เฉพาะแบบไดนามิกตามขั้นตอนการปรับใช้หรือบริบทของพื้นที่ทํางาน
• การอ้างอิงเป็นแบบคงที่ โดยชี้ไปที่รายการเฉพาะและไม่ปรับโดยอัตโนมัติในสภาพแวดล้อมต่างๆ
• สําหรับรูปแบบเฉพาะด่าน ให้ใช้ชุดค่า ซึ่งแต่ละชุดสามารถชี้ไปยังรายการคงที่ที่แตกต่างกัน (เช่น เลคเฮาส์ที่แตกต่างกันต่อด่าน)
• ค่าทั้งหมดในชุดค่า ควร เป็นชนิดรายการเดียวกันเพื่อให้แน่ใจว่าเข้ากันได้และป้องกันข้อผิดพลาดรันไทม์ อย่างไรก็ตาม เราไม่ได้บังคับให้มีประเภทไอเท็มเดียวกันในชุดค่า

การเป็นตัวแทนใน Git และ API

ไลบรารีตัวแปรได้รับการจัดการเป็นโค้ด การใช้ Git หรือ REST API ตัวแปรการอ้างอิงรายการมีรูปแบบ JSON ที่ชัดเจน ตัวแปรทั้งหมดจะปรากฏในไฟล์คําจํากัดความของไลบรารีตัวแปร (เก็บไว้ใน Git โดยปกติจะเป็น .json) แสดงคุณสมบัติ เช่น ชื่อ ประเภท และค่า

สําหรับตัวแปร การอ้างอิงรายการ (คงที่) ค่าคือข้อมูลที่มีโครงสร้างสําหรับพื้นที่ทํางานและรหัสรายการ ตัวอย่าง:

{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

 

โปรดจําสิ่งต่อไปนี้เมื่อทํางานผ่าน API:

• เก็บเฉพาะ ID เท่านั้น ชื่อและข้อมูลเมตาจะถูกดึงข้อมูลขณะรันไทม์หรือแคชไว้ใน Fabric
• การสร้าง/อัปเดตผ่าน API คุณระบุพื้นที่ทํางานและรหัสรายการ ID ที่ไม่ถูกต้องทําให้เกิดข้อผิดพลาด

รายการที่สนับสนุน

ต่อไปนี้เป็นรายการของรายการที่ได้รับการสนับสนุนในปัจจุบันโดยใช้การอ้างอิงรายการ:

• ทางลัดสําหรับเลคเฮาส์
• ฟังก์ชันข้อมูลผู้ใช้
• โน๊ตบุ๊คผ่าน NotebookUtils

Note

ไม่รองรับ Notebook, through %%configure

ตัวอย่างโค้ด Python

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการใช้การอ้างอิงรายการในสคริปต์ python

var_ref = "$(/**/VarLibItem/itemReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
workspace_id = var_obj.get("workspaceId").value()
item_id = var_obj.get("itemId").value()
print(workspace_id)
print(item_id)

รหัสนี้มีดังต่อไปนี้:

• แก้ไขตัวแปรการอ้างอิงรายการจากไลบรารีตัวแปร Fabric
• ดึงอ็อบเจ็กต์เมตาดาต้าสําหรับรายการที่อ้างอิงนั้น
• แยกรหัสพื้นที่ทํางานและรหัสรายการ
• พิมพ์เพื่อให้สามารถใช้งานได้โดยทางโปรแกรม

สิทธิ์ที่จําเป็นในการสร้าง/ใช้ตัวแปรอ้างอิงรายการ

การใช้ตัวแปรอ้างอิงรายการเกี่ยวข้องกับสิทธิ์สองชั้น:

• สร้างและแก้ไขตัวแปรอ้างอิงรายการ: ผู้ใช้ที่มีบทบาทผู้สนับสนุนหรือสูงกว่าในพื้นที่ทํางานสามารถสร้างและแก้ไขตัวแปรในไลบรารีได้
• การเข้าถึงตัวแปรอ้างอิงรายการ: นอกเหนือจากสิทธิ์ในไลบรารีตัวแปรแล้ว คุณต้องมีสิทธิ์อ่านอย่างน้อยสําหรับตัวแปรอ้างอิงรายการ ที่คุณต้องการอ้างอิง

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับสิทธิ์และการตรวจสอบสิทธิ์ ให้ดูที่ สิทธิ์ของไลบรารีตัวแปร

Limitations

ปัจจุบัน คุณสามารถอ้างอิงได้เฉพาะรายการผ้าและแบบจําลองความหมายเท่านั้น รายการ Power BI อื่นๆ เช่น Datamarts, Dataflow Gen1 ไม่ได้รับการสนับสนุนในขณะนี้

ข้อมูลการเสริม

ไลบรารีตัวแปรเปิดใช้งาน CI/CD สําหรับเนื้อหา Fabric ในสภาพแวดล้อมต่างๆ (Dev, Test, Prod) โดยใช้ตัวแปรการอ้างอิงรายการสําหรับการกําหนดค่าเฉพาะขั้นตอน โปรดระมัดระวังสิ่งต่อไปนี้:

• การอ้างอิงรายการจะเชื่อมโยงกับพื้นที่ทํางานและรหัสรายการเฉพาะ
• การปรับใช้กับขั้นตอนใหม่ การอ้างอิงเหล่านี้ยังคงชี้ไปที่พื้นที่ทํางานเดิม เว้นแต่จะมีการอัปเดตด้วยตนเอง
• ใช้หลาย Value-Sets สําหรับแต่ละขั้นตอนและเปิดใช้งานชุดที่ถูกต้องด้วยตนเองหรือผ่านสคริปต์ API

สําหรับข้อมูลเพิ่มเติม โปรดดู ชุดค่าในไลบรารีตัวแปร

เนื้อหาที่เกี่ยวข้อง

• ภาพรวมไลบรารีตัวแปร
• ประเภทตัวแปร
• ชุดค่า
• สิทธิ์ไลบรารีตัวแปร](./variable-library-permissions.md)