แปลงพารามิเตอร์ส่วนกลางของ Azure Data Factory เป็นไลบรารีตัวแปร Fabric Data Factory

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

คู่มือนี้จะแนะนําคุณตลอดกระบวนการ:

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

ทําความเข้าใจไลบรารีตัวแปร Fabric

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

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

ย้ายพารามิเตอร์ส่วนกลางของ ADF ไปยังไลบรารีตัวแปร Fabric

1. ส่งออกพารามิเตอร์ส่วนกลางของ ADF ของคุณ

   1. ใน Azure Data Factory Studio ไปที่ จัดการ>พารามิเตอร์ส่วนกลาง บันทึกชื่อ ชนิด และค่าของแต่ละพารามิเตอร์
   2. สําหรับการย้ายข้อมูลขนาดใหญ่ ให้ไปที่จัดการ>เทมเพลต ARM และส่งออกเทมเพลต ARM เพื่อแยกพารามิเตอร์โดยทางโปรแกรม คุณสามารถค้นหาได้ในโฟลเดอร์เทมเพลตภายใต้โฟลเดอร์ โรงงาน ในไฟล์ที่ลงท้ายด้วย ParametersForFactory

2. เปรียบเทียบประเภทที่มี

   ตรวจสอบประเภทพารามิเตอร์ส่วนกลาง ADF ของคุณ (สตริง, int, bool ฯลฯ) และเปรียบเทียบกับประเภทไลบรารีตัวแปร Fabric จดบันทึกความแตกต่างของประเภทที่อาจต้องปรับเปลี่ยนระหว่างการย้ายข้อมูล

3. สร้างไลบรารีตัวแปรใน Fabric

   1. ในพื้นที่ทํางาน Fabric ของคุณ ให้เลือก + รายการใหม่ จากนั้นค้นหาและเลือก ไลบรารีตัวแปร
   2. สร้างไลบรารี (ตัวอย่างเช่น GlobalParams)
   3. เปิดไลบรารีตัวแปรใหม่ แล้วเลือก +ตัวแปรใหม่ และพารามิเตอร์ส่วนกลางของ ADF แต่ละตัวเป็นตัวแปร

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

4. อัปเดตนิพจน์ไปป์ไลน์ที่ย้าย

   อัปเดตการอ้างอิงพารามิเตอร์ส่วนกลาง เช่น @globalParameters('ParamName') การอ้างอิงไลบรารีตัวแปร เช่น @pipeline.libraryVariables.ParamName.

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

5. ตรวจสอบพฤติกรรมไปป์ไลน์

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

รูปแบบการย้ายข้อมูลทั่วไป

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

• การแมปโดยตรง — พารามิเตอร์ ADF อย่างง่าย เช่น ภูมิภาคหรือชื่อผู้เช่าจะแมปแบบตัวต่อตัวกับรายการไลบรารีตัวแปร

• ไลบรารีเฉพาะสภาพแวดล้อม — แทนที่จะเป็นไลบรารีเดียว ให้สร้างไลบรารีหลายไลบรารี (Global-Dev, Global-Test Global-Prod) ไปป์ไลน์การปรับใช้สามารถผูกไลบรารีที่ถูกต้องตามสภาพแวดล้อม

• โมเดลไฮบริด — เก็บค่าคงที่ที่ใช้ร่วมกันในไลบรารีตัวแปร แต่ส่งข้อมูลเฉพาะการเรียกใช้ผ่านพารามิเตอร์ไปป์ไลน์

ข้อจํากัดปัจจุบัน

ปัจจุบันมีข้อจํากัดบางประการที่ควรระวัง:

• เครื่องมือการโยกย้าย Azure Data Factory-to-Microsoft Fabric PowerShell จะไม่โยกย้ายพารามิเตอร์ส่วนกลางโดยอัตโนมัติ
• นิพจน์ภายในบริการที่เชื่อมโยงหรือไปป์ไลน์ที่อ้างอิง @globalParameters() จะไม่ถูกเขียนใหม่โดยอัตโนมัติ
• การเชื่อมต่อแฟบริค (การแทนที่บริการที่เชื่อมโยง Azure Data Factory) ไม่สนับสนุนนิพจน์พารามิเตอร์ในลักษณะเดียวกัน คุณต้องเขียนพารามิเตอร์แบบไดนามิกที่ใช้ในข้อกําหนดการเชื่อมต่อใหม่ด้วยตนเอง

แนวทางปฏิบัติที่ดีที่สุด

โปรดคํานึงถึงเคล็ดลับเหล่านี้:

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

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

• เริ่มต้นใช้งานไลบรารีตัวแปร
• การรวมไลบรารีตัวแปรกับไปป์ไลน์
• ใช้ไลบรารีตัวแปร Fabric ใน Dataflow Gen2
• การกําหนดพารามิเตอร์การเชื่อมต่อด้วยไลบรารีตัวแปรสําหรับงานคัดลอก