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

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

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

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

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

Note

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

Limitations

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

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

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

• สร้าง/แก้ไข - แม้ว่าผู้สนับสนุนพื้นที่ทํางานสามารถปรับเปลี่ยนค่าตัวแปรได้ แต่ตัวแปรการอ้างอิงรายการจะอนุญาตให้ผู้ใช้ตั้งค่าเป็นรายการค่าที่พวกเขามีสิทธิ์ในการอ่านเท่านั้น สิ่งนี้ใช้กับค่าใดๆ ชุดค่าที่ใช้งานอยู่เริ่มต้น หรือชุดค่าอื่นๆ โปรดทราบว่าในระหว่างการบันทึกรายการไลบรารีตัวแปร จะมีการตรวจสอบสิทธิ์กับค่าที่ใช้งานอยู่ของตัวแปรอ้างอิงรายการสําหรับผู้ใช้ที่กําลังบันทึกรายการ แม้ว่าค่าเหล่านั้นจะยังคงไม่เปลี่ยนแปลงก็ตาม
• ใช้ตัวแปร item ref - เมื่อสร้าง/อัปเดตการอ้างอิงไปยังตัวแปรในสินค้าอุปโภคบริโภค ผู้ใช้จะตั้งค่าการอ้างอิงไปยังตัวแปรการอ้างอิงสินค้าไม่ได้ เว้นแต่จะมีสิทธิ์ READ เป็นอย่างน้อยสําหรับสินค้าในชุดค่าที่ใช้งานอยู่

การตรวจสอบสิทธิ์

การตรวจสอบสิทธิ์จะถูกทริกเกอร์ในกรณีการใช้งานต่อไปนี้:

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

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

• การอัปเดต API/Git - การตรวจสอบสิทธิ์จะเสร็จสิ้นในระหว่างการอัปเดต และล้มเหลวหากไม่มีสิทธิ์ในการอ่านค่าที่ใช้งานอยู่ของการอ้างอิงรายการของพื้นที่ทํางานที่อัปเดต

• การปรับใช้ - การปรับใช้ของรายการไลบรารีตัวแปรจะล้มเหลวหากไม่มีสิทธิ์ในการอ่านค่าที่ใช้งานอยู่ของ Item ref ของพื้นที่ทํางานเป้าหมาย

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

• สร้าง/แก้ไขตัวแปรอ้างอิงรายการ

  • UI - เมื่ออัปเดต ค่า ของค่าใดๆ ที่ตั้งไว้ (ค่าเริ่มต้นหรืออื่นๆ) ผู้ใช้สามารถเลือกรายการจากรายการที่แสดงเฉพาะรายการที่เขามีสิทธิ์อ่านเป็นอย่างน้อย
  • การอัปเดตหรือการปรับใช้ API/Git - ดูรายการแก้ไขไลบรารีตัวแปรด้านบน

• การใช้ตัวแปรอ้างอิงสินค้าในสินค้าอุปโภคบริโภค

  • UI - การสร้างการอ้างอิงถึงตัวแปร - เมื่อสร้างการอ้างอิงไปยังตัวแปร 'การอ้างอิงรายการ' ในรายการโดยใช้กล่องโต้ตอบ UI 'เลือกตัวแปร' (เช่น ในทางลัดสําหรับ Lakehouse และไปป์ไลน์ข้อมูล) จะมีการตรวจสอบความถูกต้องว่าผู้ใช้ที่สร้างการอ้างอิงมีสิทธิ์อ่านรายการในตัวแปร 'การอ้างอิงรายการ' เป็นอย่างน้อย (การตรวจสอบความถูกต้องมีไว้สําหรับค่าที่ใช้งานอยู่เท่านั้น) หากไม่เป็นเช่นนั้น ผู้ใช้จะเห็นเฉพาะรหัสของรายการ

พฤติกรรมในไปป์ไลน์ CI/CD และขั้นตอนการปรับใช้

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

การอ้างอิงแบบคงที่

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

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

การเป็นตัวแทนใน 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 ที่ไม่ถูกต้องทําให้เกิดข้อผิดพลาด

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

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