แชร์ผ่าน


ชนิดตัวแปรในไลบรารีตัวแปร

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

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

  • ชนิดตัวแปรพื้นฐานในไลบรารีตัวแปรประกอบด้วยชนิดข้อมูลอย่างง่าย เช่น บูลีน วันที่เวลา (ในรูปแบบ ISO 8601 UTC), Guid, จํานวนเต็ม, ตัวเลข และสตริง ค่าเหล่านี้เป็นค่าที่ตรงไปตรงมาซึ่งสามารถกําหนดและใช้งานได้โดยตรงในขั้นตอนและสภาพแวดล้อมต่างๆ
  • ชนิดตัวแปรขั้นสูงได้รับการออกแบบมาสําหรับกรณีการใช้งานที่ซับซ้อนยิ่งขึ้น เช่น การอ้างอิงรายการ Fabric ภายในหรือการเชื่อมต่อภายนอก ซึ่งรวมถึงชนิด "การอ้างอิงสินค้า" ซึ่งพื้นที่ทํางานของร้านค้าและรหัสสินค้าเพื่อชี้ไปยังสินค้า Fabric ที่เฉพาะเจาะจง

ชนิดที่สนับสนุนในไลบรารีตัวแปร

ตัวแปรภายในไลบรารีตัวแปรมีชนิดตัวแปรที่รองรับดังต่อไปนี้

ประเภทประเภท ประเภท คำอธิบาย
แบบบูลีน พื้นฐาน แสดงถึงค่าจริง/เท็จ
จำนวนเต็ม พื้นฐาน จํานวนเต็มที่ไม่มีทศนิยม
ตัวเลข พื้นฐาน ค่าตัวเลข รวมถึงทศนิยม
สตริง พื้นฐาน ค่าข้อความหรือลําดับของอักขระ
DateTime พื้นฐาน วันที่และเวลาที่แสดงเป็นมาตรฐาน ISO 8601 yyyy-MM-ddTHH:mm:ss.xxxZ โดยที่:
yyyy-MM-dd คือปีสี่หลัก ตามด้วยเดือนสองหลักและวันสองหลัก
T แยกวันที่และเวลา
HH:mm:ss.xxx คือชั่วโมงสองหลักในรูปแบบ 24 ชั่วโมง ตามด้วยนาทีสองหลัก วินาทีสองหลัก และมิลลิวินาทีสามหลัก
Z ระบุว่าเวลาอยู่ในเวลาสากลเชิงพิกัด (UTC)
Guid พื้นฐาน ตัวระบุที่ไม่ซ้ํากันทั่วโลกที่ใช้สําหรับการระบุวัตถุที่แตกต่างกัน
การอ้างอิงรายการ ขั้นสูง ใช้ภายในไลบรารีตัวแปร Fabric เพื่อเก็บการอ้างอิงไปยังรายการ Fabric ที่มีอยู่ เช่น เลคเฮาส์ สมุดบันทึก หรือไปป์ไลน์ข้อมูล โดยการจัดเก็บรหัสพื้นที่ทํางานและรหัสรายการ

คุณสมบัติตัวแปร

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

ทรัพย์สิน คำอธิบาย
ชื่อ ตัวระบุเฉพาะสําหรับตัวแปร ใช้เพื่ออ้างอิงตัวแปรในสคริปต์หรือเวิร์กโฟลว์
หมายเหตุ (ไม่บังคับ) ข้อคิดเห็นหรือคําอธิบายประกอบที่อธิบายเกี่ยวกับตัวแปร สามารถรวมบริบท บันทึกการใช้งาน หรือคําแนะนําพิเศษ ความยาวสูงสุด: 2,048 ตัวอักษร
ประเภท กําหนดชนิดข้อมูลของตัวแปร (เช่น สตริง จํานวนเต็ม บูลีน อาร์เรย์) กําหนดวิธีการตีความและตรวจสอบความถูกต้องของค่า
ชุดค่าเริ่มต้น ค่าเริ่มต้นที่กําหนดให้กับตัวแปรเมื่อไม่มีการระบุค่าอื่น รับรองพฤติกรรมที่สอดคล้องกันในเวิร์กโฟลว์ ไม่สามารถเปลี่ยนชื่อชุดค่าเริ่มต้นได้
ชุดค่าทางเลือก (ไม่บังคับ) ชุดค่าที่กําหนดไว้ล่วงหน้าเพิ่มเติมที่สามารถนําไปใช้ภายใต้เงื่อนไขหรือสถานการณ์เฉพาะ มีประโยชน์สําหรับการกําหนดค่าเฉพาะสภาพแวดล้อมหรือตัวเลือกสํารอง

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

ชื่อตัวแปร

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

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

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

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

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

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

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

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

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

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

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