สร้างและจัดการไลบรารีตัวแปร

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

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

Prerequisites

ในการสร้างรายการไลบรารีตัวแปรใน Fabric คุณต้อง:

• บัญชีผู้เช่า Fabric ที่มีการสมัครใช้งานที่ใช้งานอยู่ สร้างบัญชีฟรี

• พื้นที่ทํางาน ที่มีความจุ ที่เปิดใช้งาน Microsoft Fabric

• สวิตช์ผู้เช่าต่อไปนี้เปิดใช้งานจากพอร์ทัลผู้ดูแลระบบ:

  • ผู้ใช้สามารถสร้างรายการ Fabric ได้

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

ข้อควรพิจารณาด้านความปลอดภัยและการจัดการสิทธิ์สําหรับไลบรารีตัวแปร Fabric

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

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

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

เพื่อลดความเสี่ยงเหล่านี้ ให้ปฏิบัติตามแนวทางปฏิบัติที่สําคัญเหล่านี้:

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

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

สร้างรายการไลบรารีตัวแปร

คุณสามารถสร้างรายการไลบรารีตัวแปรได้จากโฮมเพจ Fabric หรือจากภายในพื้นที่ทํางานของคุณ:

ไลบรารีตัวแปรว่างเปล่าจะปรากฏขึ้น ตอนนี้คุณสามารถเพิ่มตัวแปรลงในตัวแปรได้แล้ว

จัดการไลบรารีตัวแปรและตัวแปร

คุณสามารถจัดการตัวแปรในไลบรารีตัวแปรได้จากแถบเมนูด้านบน

เพิ่มตัวแปร

วิธีการเพิ่มตัวแปรใหม่ลงในไลบรารี:

1. เลือก + ตัวแปรใหม่
2. ป้อนชื่อ ตรวจสอบให้แน่ใจว่าเป็นไปตามแบบแผนการตั้งชื่อ
3. ในรายการดรอปดาวน์ ให้เลือกประเภท ดูรายการประเภทตัวแปรที่รองรับ
4. ป้อนค่าเริ่มต้น
5. เพิ่มโน้ตที่อธิบายว่าตัวแปรมีไว้เพื่ออะไรหรือใช้งานอย่างไร (ไม่บังคับ)
6. เลือก บันทึก

ลบหรือแก้ไขตัวแปร

• เมื่อต้องการลบตัวแปร ให้เลือกตัวแปรอย่างน้อยหนึ่งตัว แล้วเลือก ลบตัวแปร>บันทึก
• เมื่อต้องการแก้ไขชื่อ ชนิด หรือชุดค่าของตัวแปร ให้เปลี่ยนค่า แล้วเลือก บันทึก
• เมื่อต้องการเพิ่มชุดค่าอื่น ให้เลือก เพิ่มชุดค่า

เพิ่มชุดค่า

เมื่อต้องการเพิ่มชุดค่าอื่นที่คุณสามารถใช้ในขั้นตอนอื่น:

1. เลือก เพิ่มชุดค่า

2. ตั้งชื่อชุดค่า ตรวจสอบให้แน่ใจว่าเป็นไปตามแบบแผนการตั้งชื่อ ให้คําอธิบาย (ไม่บังคับ) สูงสุด 2,048 อักขระ

3. ถ้าคุณต้องการใช้ค่านี้เป็นค่าที่ใช้งานอยู่ในปัจจุบันที่ตั้งค่าในพื้นที่ทํางานนี้ ให้เลือก ตั้งค่าเป็นใช้งานอยู่

4. ป้อนค่าสําหรับตัวแปรทั้งหมดในไลบรารีตัวแปร

5. เลือก บันทึก

แก้ไขชุดค่า

วิธีแก้ไขชุดค่า

1. เลือกจุดสามจุดถัดจากชื่อของชุดค่า

2. เลือก ตั้งค่าเป็นใช้งานอยู่ (สําหรับพื้นที่ทํางานนี้) เปลี่ยนชื่อ หรือ ลบ

   

3. เลือก บันทึก การเปลี่ยนแปลงจะมีผลหลังจากที่คุณบันทึกแล้วเท่านั้น

หากต้องการรีเซ็ตค่าของแต่ละตัวแปรเป็นค่าเริ่มต้น ให้เลือกปุ่มรีเซ็ต

ข้อควรพิจารณาและข้อจำกัด

ข้อจํากัดของขนาด

• สามารถมี ตัวแปรได้สูงสุด 1,000 ตัวและชุด ค่าได้สูงสุด 1,000 ชุด ตราบใดที่คุณมีคุณสมบัติตรงตามข้อกําหนดทั้งสองข้อนี้:

  • จํานวนเซลล์ทั้งหมดในชุดค่าทางเลือกน้อยกว่า 10,000 เซลล์
  • ขนาดของสินค้าไม่เกิน 1 MB

  ข้อกําหนดเหล่านี้จะได้รับการตรวจสอบเมื่อคุณบันทึกการเปลี่ยนแปลง

• เขตข้อมูลหมายเหตุสามารถมีอักขระได้สูงสุด 2,048 อักขระ

• เขตข้อมูลคําอธิบายของชุดค่าสามารถมีอักขระได้สูงสุด 2,048 อักขระ

ข้อจํากัดสําหรับชุดค่าทางเลือก

• ชุดค่าทางเลือกในไลบรารีตัวแปรจะปรากฏตามลําดับที่คุณเพิ่ม ในปัจจุบัน คุณไม่สามารถจัดลําดับใหม่ใน UI หากต้องการเปลี่ยนลําดับ แก้ไขไฟล์ JSON โดยตรง
• ชื่อของชุดค่าแต่ละชุดต้องไม่ซ้ํากันภายในไลบรารีตัวแปร
• ชื่อตัวแปรต้องไม่ซ้ํากันภายในไลบรารีตัวแปร คุณสามารถมีตัวแปรสองตัวที่มีชื่อเดียวกันในพื้นที่ทํางานได้หากอยู่ในรายการที่แตกต่างกัน
• มีค่าที่ใช้งานอยู่หนึ่งค่า (และเพียงค่าเดียว) ที่ตั้งค่าไว้ในไลบรารีตัวแปรในแต่ละครั้ง คุณไม่สามารถลบค่าที่ตั้งค่าในขณะที่ค่านั้นทํางานอยู่ หากต้องการลบ ให้กําหนดค่าชุดค่าอื่นให้ใช้งานก่อน คุณสามารถตั้งค่าที่ใช้งานอยู่ที่แตกต่างกันสําหรับแต่ละขั้นตอนของไปป์ไลน์การปรับใช้