ชื่อและชนิดตัวแปร

รายการไลบรารีตัวแปรใน Microsoft Fabric ประกอบด้วยรายการของตัวแปรและค่าเริ่มต้น นอกจากนี้ยังสามารถมีชุดค่าอื่นๆ ที่เก็บค่าทางเลือก

ตัวแปรแต่ละตัวในไลบรารีตัวแปรมีคุณสมบัติดังต่อไปนี้:

• ชื่อ
• หมายเหตุ (ไม่บังคับ) สูงสุด 2,048 อักขระ
• ประเภท
• ชุดค่าเริ่มต้น
• ชุดค่าอื่น (ไม่บังคับ)

มาตรฐานการตั้งชื่อ

ชื่อไลบรารีตัวแปร

ชื่อของรายการไลบรารีตัวแปรต้องเป็นไปตามข้อตกลงเหล่านี้:

• ไม่ว่างเปล่า
• ไม่มีช่องว่างนําหน้าหรือต่อท้าย
• เริ่มต้นด้วยตัวอักษร
• สามารถรวมตัวอักษร ตัวเลข ขีดล่าง ยัติภังค์ และช่องว่างได้
• ความยาวไม่เกิน 256 อักขระ

ชื่อไลบรารีตัว แปรไม่คํานึงถึง ตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

ชื่อตัวแปร

ชื่อของตัวแปรภายในไลบรารีตัวแปรต้องเป็นไปตามข้อตกลงเหล่านี้:

• ไม่ว่างเปล่า
• ไม่มีช่องว่างนําหน้าหรือต่อท้าย
• ขึ้นต้นด้วยตัวอักษรหรือขีดล่าง
• สามารถรวมตัวอักษร ตัวเลข ขีดล่าง และยัติภังค์ได้
• ความยาวไม่เกิน 256 อักขระ

ชื่อตัวแปร ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก

ชื่อชุดค่า

ชื่อชุดค่ามีข้อจํากัดเหมือนกับชื่อตัวแปร

ชนิดตัวแปร

ก่อนที่คุณจะสามารถเพิ่มค่าให้กับตัวแปรได้ ตัวแปรในไลบรารีตัวแปรสามารถเป็นประเภทใดก็ได้ต่อไปนี้:

• สตริง: อักขระใดก็ได้ สามารถเป็นหรือ null ว่างเปล่า

• บูลีน: True หรือ False.

• วันที่และเวลา: วันที่และเวลาที่แสดงเป็นมาตรฐาน ISO 8601 yyyy-MM-ddTHH:mm:ss.xxxZ โดยที่:

  • yyyy-MM-dd คือปีสี่หลัก ตามด้วยเดือนสองหลักและวันสองหลัก
  • T แยกวันที่และเวลา
  • HH:mm:ss.xxx คือชั่วโมงสองหลักในรูปแบบ 24 ชั่วโมง ตามด้วยนาทีสองหลัก สองหลักวินาที และสามหลักมิลลิวินาที
  • Z ระบุว่าเวลาอยู่ในเวลาสากลเชิงพิกัด (UTC)

  ตัวอย่างคือ 2025-01-14T16:15:20.123Z.

• หมายเลข: หมายเลขใดก็ได้

• GUID: ตัวระบุที่ไม่ซ้ํากันทั่วโลก

• จํานวนเต็ม: จํานวนเต็มที่สามารถเป็นบวก ลบ หรือศูนย์

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

ชุดค่าสํารอง

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

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

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

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

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

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

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

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

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

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

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