แก้ไขปัญหาแผนการปรับใช้ (ตัวอย่าง)

ปัญหาแผนการปรับใช้แบ่งออกเป็นสองกลุ่ม: ปัญหาในแผนเองที่คุณเห็นขณะเขียน และปัญหาที่เกิดขึ้นระหว่างการปรับใช้ที่มีแผนแนบมาด้วย

ปัญหาขณะคุณเขียนแผน

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

แผนนี้ช่วยไม่ได้

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

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

  • ผ่านแผนการปรับใช้ REST API
  • ผ่านการดึงข้อมูลจาก Git ซึ่งแผนถูกแก้ไขในคลังข้อมูล
  • ผ่านเครื่องมือภายนอกหรือสาย CI/CD ที่เขียนคํานิยามแผนโดยตรง

ในกรณีเหล่านั้น การบันทึกจะถูกปฏิเสธและข้อผิดพลาดจะระบุองค์ประกอบที่ทําให้เกิดข้อผิดพลาดนั้น

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

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

แผนสามารถบันทึกได้ แต่จะแสดงคําเตือน

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

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

Note

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

ปัญหาระหว่างการปฏิบัติงาน

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

การปฏิบัติการหยุดกลางคัน

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

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

การดําเนินการล้มเหลว

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

การดําเนินการล้มเหลวเนื่องจากพื้นที่ทํางานไม่ได้กําหนดค่า

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

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

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

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

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

การกระทําถัดไปเริ่มเร็วเกินไป

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

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

การดําเนินการ Dataflow Gen2 ล้มเหลวในเหตุการณ์ที่สอง

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

ลบการกระทําซ้ํา

ผลลัพธ์ของฟังก์ชันข้อมูลผู้ใช้ไม่สมบูรณ์

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

แผนไม่ได้อยู่ในเครื่องเลือก

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