แชร์ผ่าน

ทําให้ไปป์ไลน์การปรับใช้งานของคุณเป็นอัตโนมัติด้วย Fabric APIs

  • บทความ

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

สำคัญ

คุณลักษณะนี้อยู่ในตัวอย่าง

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

  • รวม Fabric เข้ากับเครื่องมือ DevOps ที่คุ้นเคย เช่น Azure DevOps หรือการดําเนินการ GitHub

  • กําหนดเวลาการปรับใช้ไปป์ไลน์ให้เกิดขึ้นโดยอัตโนมัติในเวลาที่ระบุ

  • ปรับใช้ไปป์ไลน์หลายรายการในเวลาเดียวกัน

  • แบบเรียงซ้อนขึ้นอยู่กับการปรับใช้ไปป์ไลน์ ถ้าคุณมีเนื้อหาที่เชื่อมต่อข้ามไปป์ไลน์ คุณสามารถตรวจสอบให้แน่ใจว่ามีการปรับใช้ไปป์ไลน์บางอย่างก่อนอื่น

ข้อกำหนดเบื้องต้น

เมื่อต้องการทํางานกับ API ของไปป์ไลน์การปรับใช้ คุณจําเป็นต้องมีข้อกําหนดเบื้องต้นต่อไปนี้:

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

คุณสามารถใช้ REST API โดยไม่มี PowerShell ได้ แต่สคริปต์ในบทความนี้ใช้ PowerShell เมื่อต้องการเรียกใช้สคริปต์ คุณจําเป็นต้องติดตั้งโปรแกรมต่อไปนี้:

ฟังก์ชัน API ของไปป์ไลน์การปรับใช้

ไป ป์ไลน์การปรับใช้ Fabric REST API ช่วยให้คุณสามารถดําเนินการฟังก์ชันต่อไปนี้:

  • รับไปป์ไลน์การปรับใช้: ส่งกลับข้อมูลเกี่ยวกับไปป์ไลน์การปรับใช้งานที่ระบุ

  • รายการไปป์ไลน์การปรับใช้: ส่งกลับรายการของไปป์ไลน์การปรับใช้ที่ผู้ใช้มีสิทธิ์เข้าถึง

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

  • รายการขั้นตอนการปรับใช้ขั้นตอนการปรับใช้: ส่งกลับหน่วยข้อมูลที่สนับสนุนจากพื้นที่ทํางานที่กําหนดให้กับขั้นตอนที่ระบุของไปป์ไลน์การปรับใช้งานที่ระบุ

  • ปรับใช้เนื้อหาขั้นตอน: ปรับใช้รายการจากขั้นตอนที่ระบุของไปป์ไลน์การปรับใช้งานที่ระบุ

    • ใช้ API นี้เพื่อปรับใช้รายการทั้งหมดหรือเลือกรายการเฉพาะที่จะปรับใช้ ถ้าไม่มีรายการใดถูกเลือก หน่วยข้อมูลทั้งหมดจะถูกปรับใช้

    • เมื่อต้องการค้นหา ID ลําดับขั้นที่เกี่ยวข้องเพื่อปรับใช้ ให้ใช้ API ขั้นตอนการปรับใช้ของไป ป์ไลน์รายการ

    • API นี้ถูกรวมเข้ากับ API การดําเนินงานที่ใช้เวลานานเพื่อตรวจสอบสถานะการปรับใช้

      • รับสถานะการดําเนินการเพื่อดูว่าการดําเนินการเสร็จสมบูรณ์หรือไม่ด้วย API รับเรียกใช้ที่นาน - รับสถานะ การดําเนินการ
      • เป็นเวลา 24 ชั่วโมงหลังจากการปรับใช้เสร็จสมบูรณ์ ข้อมูลการปรับใช้ที่ขยายจะพร้อมใช้งานในรับผลลัพธ์ การดําเนินการ API

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

ตัวอย่างของ PowerShell

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

  • ปรับใช้ทั้งหมด

    ระบุข้อมูลต่อไปนี้:

    • ชื่อไปป์ไลน์
    • ชื่อขั้นตอนต้นทาง
    • ชื่อขั้นตอนเป้าหมาย
    • บันทึกย่อการปรับใช้ (ไม่บังคับ)

  • การปรับใช้ที่เลือก

    ระบุข้อมูลต่อไปนี้:

    • ชื่อไปป์ไลน์
    • ชื่อขั้นตอนต้นทาง
    • ชื่อขั้นตอนเป้าหมาย
    • รายการที่จะปรับใช้ (ชื่อที่แสดงรายการและชนิดรายการ)
    • บันทึกย่อการปรับใช้ (ไม่บังคับ)

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

เมื่อใช้ API ของไปป์ไลน์การปรับใช้ ให้พิจารณาข้อจํากัดต่อไปนี้:

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

  • กระแสข้อมูลยังไม่ได้รับการสนับสนุนในขณะนี้ ลูกค้าที่ใช้กระแสข้อมูลสามารถใช้ API ของ Power BI ได้

  • บริการหลักได้รับการสนับสนุนสําหรับรายการ Power BI เท่านั้น

  • ไม่มีตัวเลือกการปรับใช้ทั้งหมดที่พร้อมใช้งานใน API ของ Power BI ใช้ได้ใน Fabric API ต่อไปนี้ไม่ สามารถใช้งานได้ใน API ของขั้นตอนการปรับใช้ของ Fabric:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    ถ้าคุณต้องการหนึ่งใน API เหล่านี้ ใช้ API ของ Power BI เพื่อปรับใช้ อย่างไรก็ตาม API เหล่านี้จะใช้ได้กับรายการ Power BI เท่านั้น

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