แชร์ผ่าน


การรวมไลบรารีตัวแปรกับไปป์ไลน์

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

วิธีใช้ไลบรารีตัวแปรกับไปป์ไลน์

  1. นําทางไปยังพื้นที่ทํางานของคุณและสร้างรายการใหม่

    สกรีนช็อตที่แสดงตําแหน่งที่จะเพิ่มรายการใหม่ในพื้นที่ทํางาน Fabric ของคุณที่ถูกเน้น

  2. ใช้ตัวกรองเพื่อค้นหาไลบรารีตัวแปรหรือเลื่อนลงไปที่ส่วนพัฒนาข้อมูล

    สกรีนช็อตที่แสดงตัวกรองสําหรับรายการไลบรารีตัวแปรใหม่

  3. เลือกไลบรารีตัวแปรเพื่อสร้างไลบรารีตัวแปรใหม่ เลือกชื่อและกดสร้าง

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

  4. เมื่อสร้างไลบรารีตัวแปรแล้ว คุณจะถูกนําไปยังโฮมเพจ คลิก + สร้าง เพื่อเพิ่มตัวแปรใหม่

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

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

    สกรีนช็อตที่แสดงการกําหนดค่าเพื่อตั้งค่าสําหรับตัวแปรใหม่

  6. เพิ่มชุดค่าทางเลือกตามที่คุณต้องการ (ตัวอย่างเช่น ค่าที่แตกต่างกันสําหรับสภาพแวดล้อมไปป์ไลน์การปรับใช้ที่แตกต่างกัน) หลังจากที่คุณตั้งชื่อและคลิก "สร้าง" แล้ว คุณจะสามารถแก้ไขค่าตัวแปรและเลือกค่าที่ตั้งค่าให้เปิดใช้งานได้

    สกรีนช็อตที่เน้นตําแหน่งที่จะเพิ่มชุดค่าใหม่สําหรับตัวแปร

    สกรีนช็อตที่แสดงวิธีการเพิ่มชื่อสําหรับชุดค่าใหม่

  7. บันทึกการเปลี่ยนแปลงของคุณเมื่อคุณทําเสร็จแล้ว

สกรีนช็อตที่แสดงปุ่มบันทึกที่เน้นในมุมบนซ้าย

ใช้ตัวแปรไลบรารีตัวแปรในไปป์ไลน์ของคุณ

  1. หากต้องการใช้ตัวแปรไลบรารีตัวแปรในไปป์ไลน์ของคุณ ให้สร้างไปป์ไลน์ใหม่หรือนําทางไปยังไปป์ไลน์ที่มีอยู่

    สกรีนช็อตที่เน้นปุ่มสร้างรายการใหม่ที่มุมซ้ายบนและรายการไปป์ไลน์ที่ไฮไลต์

  2. ในไปป์ไลน์ คุณต้องสร้างการอ้างอิงไปยังตัวแปรไลบรารีตัวแปรของคุณในแผงด้านล่าง

    สกรีนช็อตที่เน้นแท็บ ตัวแปรไลบรารี และปุ่ม +ใหม่ ในแผงด้านล่างของพื้นที่ทํางานไปป์ไลน์

  3. หลังจากที่คุณคลิก + สร้าง ป๊อปอัปจะเปิดขึ้นซึ่งแสดงไลบรารีตัวแปรทั้งหมดของคุณ คุณสามารถใช้ตัวเลือกนี้เพื่อเลือกตัวแปรไลบรารีตัวแปร แล้วคลิก ตกลง

    สกรีนช็อตที่แสดงปุ่ม +ใหม่ ในแท็บ ตัวแปรไลบรารี ถูกเน้น

    สกรีนช็อตที่แสดงตัวแปรไลบรารีที่เลือกในตัวเลือกตัวแปร

    สกรีนช็อตที่แสดงชุดการกําหนดค่าสําหรับการอ้างอิงตัวแปรไลบรารีใหม่

  4. เมื่อคุณเพิ่มการอ้างอิงตัวแปรไลบรารีของคุณแล้ว ให้เพิ่มกิจกรรมไปป์ไลน์ของคุณ ในการตั้งค่ากิจกรรม ให้คลิก เพิ่มเนื้อหาแบบไดนามิก สําหรับการตั้งค่าที่ต้องการกําหนดพารามิเตอร์

    สกรีนช็อตที่แสดงเพิ่มเนื้อหาแบบไดนามิกที่เน้นในการตั้งค่าของกิจกรรมการค้นหา

  5. ตัวสร้างนิพจน์เปิดขึ้น หากไม่เห็นตัวแปรไลบรารี ให้คลิกจุด 3 จุดถัดจากฟังก์ชัน แล้วเลือกตัวแปรไลบรารี

    สกรีนช็อตแสดงจุด 3 จุดถัดจากฟังก์ชันในตัวสร้างนิพจน์และแท็บตัวแปรไลบรารีถูกเน้น

  6. คลิกที่การอ้างอิงตัวแปรไลบรารีของคุณเพื่อเพิ่มนิพจน์ใหม่ให้กับตัวสร้างนิพจน์ จากนั้นคลิก ตกลง เพื่อเพิ่มนิพจน์ของคุณ

    สกรีนช็อตที่แสดงการอ้างอิงตัวแปรไลบรารีที่เน้นเพื่อเพิ่มลงในตัวสร้างนิพจน์

    สกรีนช็อตที่แสดงนิพจน์ที่ตั้งค่าในตัวสร้างนิพจน์

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

    สกรีนช็อตที่แสดงนิพจน์ที่ตั้งค่าเป็นเนื้อหาแบบไดนามิกในการตั้งค่ากิจกรรมการค้นหา

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

    สกรีนช็อตที่แสดงตัวเลือกข้อมูลตัวอย่าง

    สกรีนช็อตที่แสดงบานหน้าต่างข้อมูลตัวอย่าง

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

    สกรีนช็อตที่แสดงการตั้งค่าบันทึกและเรียกใช้ที่เน้นบนพื้นที่ทํางานของไปป์ไลน์

ข้อจำกัดที่ทราบ

ข้อจํากัดที่ทราบต่อไปนี้นําไปใช้กับการรวมไลบรารีตัวแปรในไปป์ไลน์ใน Data Factory ใน Microsoft Fabric:

  • ไลบรารีตัวแปรสนับสนุนบูลีน วันที่เวลา Guid จํานวนเต็ม ตัวเลข และสตริงเป็นชนิดข้อมูล ในไปป์ไลน์ของคุณ คุณจะเห็นบูลีนเป็นประเภท Bool, วันที่และเวลาเป็นประเภทสตริง, Guid เป็นประเภทสตริง, จํานวนเต็มเป็นประเภท Int และสตริงเป็นประเภทสตริง ชนิดตัวเลขไม่ได้รับการสนับสนุนในไปป์ไลน์
  • การกําหนดพารามิเตอร์การเชื่อมต่อภายนอกได้รับการสนับสนุนด้วยไลบรารีตัวแปรที่รวมเข้ากับไปป์ไลน์ อย่างไรก็ตาม คุณต้องค้นหา GUID สําหรับการเชื่อมต่อของคุณจาก การตั้งค่า | การตั้งค่า จัดการการเชื่อมต่อและเกตเวย์ คุณจะพบ GUID สําหรับการเชื่อมต่อของคุณโดยเลือกการตั้งค่าถัดจากชื่อการเชื่อมต่อของคุณ