การดําเนินการแผนการปรับใช้ (ตัวอย่าง)

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

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

Important

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

การดําเนินการก่อนและหลังการติดตั้ง

แต่ละกลุ่มการปรับใช้มีชุดการดําเนินการสองชุด:

  • การดําเนินการก่อนปรับใช้ จะทํางานก่อนที่รายการของกลุ่มจะถูกปรับใช้
  • การดําเนินการหลังการปรับใช้ จะทํางานหลังจากที่รายการของกลุ่มถูกปรับใช้แล้ว

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

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

ประเภทไอเท็มที่คุณสามารถรันเป็นแอ็กชัน

ประเภทรายการต่อไปนี้สามารถรันเป็นการดําเนินการแผนการปรับใช้ได้:

ชนิดสินค้า ชนิดงาน
Notebook Execute
ไปป์ไลน์ข้อมูล Execute
ระบบการไหลเวียนข้อมูล Gen2 Execute
งานคัดลอก Execute
ฟังก์ชันข้อมูลผู้ใช้ Execute

สําหรับโครงสร้างคํานิยามและคุณสมบัติงาน ดูที่ คําจํากัดความแผนการปรับใช้

แต่ละการกระทําจะรันไอเท็มนั้น รายการนี้กําหนดว่าการกระทําทําอะไรและยอมรับพารามิเตอร์ใดบ้าง ไม่ใช่แผน

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

คําสั่งการดําเนินการภายในกลุ่มการปรับใช้

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

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

ในภาพก่อนหน้า โซ่ในกลุ่มบ้านพักน้ําจะวิ่ง Refresh_Sales นําหน้า Validate_Sales. กลุ่มคลังสินค้าต่อไปนี้จะทํางาน Notify ก่อนที่จะปรับใช้คลังสินค้า

ใช้กฎต่อไปนี้:

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

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

ส่งพารามิเตอร์ไปยังการกระทํา

การกระทําสามารถมีพารามิเตอร์ ซึ่งแผนจะส่งต่อไปยังรายการที่การดําเนินการนั้นรัน แต่ละพารามิเตอร์มีชื่อและค่า และชื่อพารามิเตอร์ต้องไม่ซ้ํากันภายในแอ็กชัน

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

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

การอ้างอิงตัวแปรที่ไม่แก้ไขเป็นประเภทตัวแปรที่รู้จักจะถูกปฏิเสธเมื่อแผนถูกบันทึก

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

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

ข้อจํากัดของแผนการติดตั้งทั่วไป

  • คุณไม่สามารถใช้แผนเดียวเพื่อปรับใช้ใน workspace มากกว่าหนึ่งแห่งในรอบเดียว
  • คุณสามารถแนบแผนการปรับใช้ได้เพียงแผนเดียวกับการดําเนินการปรับใช้หนึ่งครั้ง

ข้อจํากัดในการแนบแผนงาน

  • แผนที่แนบจะใช้ได้เฉพาะกับการดําเนินการปัจจุบันเท่านั้น คุณไม่สามารถกําหนดแผนเป็นค่าเริ่มต้นสําหรับการปรับใช้ในอนาคตหรือกําหนดเวลาแผนเองได้ หากเครื่องมือปรับใช้กําหนดเวลาการดําเนินการ การดําเนินการนั้นต้องแนบแผนทุกครั้งที่รัน
  • คุณไม่สามารถแนบแผนงานกับการนําเข้ารายการเดียวได้
  • ไลบรารีไม่ fabric-cicd รองรับแผนการนําไปใช้งาน

ข้อจํากัดระหว่างการปรับใช้

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

ข้อจํากัดสําหรับการดําเนินการตามแผน

  • เฉพาะการรวมประเภทรายการและงานที่รองรับเท่านั้นที่สามารถทํางานเป็นการดําเนินการก่อนปรับใช้หรือหลังการปรับใช้ได้ ดูที่ ประเภทไอเท็มที่คุณสามารถรันเป็นการกระทํา
  • คุณไม่สามารถใช้รายการ Dataflow Gen2 เดียวกันในหลายการกระทําในแผนได้ งานรีเฟรชของมันไม่สามารถรันซ้ําได้มากกว่าหนึ่งครั้งพร้อมกัน ดังนั้น canvas จะเตือนเมื่อคุณเพิ่มเหตุการณ์ที่สอง และครั้งที่สองจะถูกบล็อกระหว่างการปรับใช้
  • คุณไม่สามารถส่งคืนพื้นที่เกิน 512 KB จากการดําเนินการฟังก์ชันข้อมูลผู้ใช้ได้ ผลลัพธ์ที่มากขึ้นจะถูกตัดทอน แต่การกระทําก็ยังประสบความสําเร็จ
  • คุณไม่สามารถให้การกระทํารอให้บริการที่มันป้อนตามทันได้ การกระทําจะเสร็จสิ้นเมื่อการกระทํานั้นสิ้นสุดลง ดังนั้นการกระทําถัดไปสามารถเริ่มได้ก่อนที่ข้อมูลที่สร้างขึ้นจะสามารถสอบถามได้
  • คุณไม่สามารถใช้แผนการปรับใช้เพื่อเปลี่ยนชุดค่าที่ใช้งานอยู่ของ ไลบรารีตัวแปร ในระหว่างการปรับใช้ได้ การอ้างอิงตัวแปรจะทํางานกับชุดค่าที่เปิดใช้งานอยู่แล้วในพื้นที่ทํางานเป้าหมาย ในพื้นที่ทํางานเป้าหมายที่สร้างขึ้นใหม่ ค่าเริ่มต้น จะทํางานจนกว่าคุณจะเลือกและบันทึกชุดค่าอื่น สําหรับข้อมูลเพิ่มเติม ดูที่ Variable library CI/CD

ข้อจํากัดสําหรับการสร้างแผน

  • คุณไม่สามารถเพิ่มรายการมากกว่าหนึ่งรายการในกลุ่มการปรับใช้ได้
  • แคนวาสรองรับการจัดวางแบบอัตโนมัติเท่านั้น

ขีดจํากัดขนาดแผนการปรับใช้

แผนที่เกินขีดจํากัดเหล่านี้จะถูกปฏิเสธเมื่อบันทึกไว้ ข้อจํากัดเหล่านี้จะถูกบังคับใช้ทุกครั้งที่บันทึกแผน ดังนั้นมันจะครอบคลุมทั้ง canvas, REST API, การดึงข้อมูลจาก Git และเครื่องมือภายนอก

องค์ประกอบ ขีดจำกัด
ขนาดแผน 1 เมกะไบต์
ความยาวของชื่อกลุ่มหรือขั้นตอน 60 ตัวอักษร
กลุ่มในแผน 1,000
การพึ่งพากลุ่ม 1,000
ปรับใช้การดําเนินการล่วงหน้าในกลุ่ม 20
การดําเนินการหลังการปรับใช้ในกลุ่ม 20
การพึ่งพาการกระทํา 20
พารามิเตอร์บนการกระทํา 20