หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ปัญหาแผนการปรับใช้แบ่งออกเป็นสองกลุ่ม: ปัญหาในแผนเองที่คุณเห็นขณะเขียน และปัญหาที่เกิดขึ้นระหว่างการปรับใช้ที่มีแผนแนบมาด้วย
ปัญหาขณะคุณเขียนแผน
แคนวาสจะตรวจสอบความถูกต้องของแผนงานขณะที่คุณแก้ไข บางปัญหาจะบล็อกไม่ให้บันทึก และบางปัญหาก็แค่เตือนเท่านั้น
แผนนี้ช่วยไม่ได้
ปัญหาเหล่านี้หมายความว่าแผนงานไม่สอดคล้องกันภายใน พวกเขาไม่ต้องพึ่งพาพื้นที่ทํางานใด ๆ ดังนั้นการซ่อมจึงอยู่ในการควบคุมของคุณเสมอ
แคนวาสจะป้องกันส่วนใหญ่ขณะที่คุณแก้ไข เพราะไม่ให้คุณสร้างแผนที่ไม่ถูกต้องตั้งแต่แรก กฎเหล่านี้จะถูกบังคับใช้เมื่อแผนถูกบันทึก ไม่ใช่โดยแคนวาส ดังนั้นจึงใช้กับทุกเส้นทางที่แผนสามารถนําเข้าสู่พื้นที่ทํางานได้ คุณมีโอกาสพบพวกเขามากที่สุดเมื่อแผนการมาถึงในรูปแบบอื่น:
- ผ่านแผนการปรับใช้ REST API
- ผ่านการดึงข้อมูลจาก Git ซึ่งแผนถูกแก้ไขในคลังข้อมูล
- ผ่านเครื่องมือภายนอกหรือสาย CI/CD ที่เขียนคํานิยามแผนโดยตรง
ในกรณีเหล่านั้น การบันทึกจะถูกปฏิเสธและข้อผิดพลาดจะระบุองค์ประกอบที่ทําให้เกิดข้อผิดพลาดนั้น
| ปัญหา | สาเหตุ | ความละเอียด |
|---|---|---|
| แผนผังประกอบด้วยวงจร | กลุ่มการปฏิบัติการสองกลุ่มขึ้นไปจะพึ่งพากันโดยตรงหรือผ่านสายโซ่ รอบยังนับเมื่อสายรันผ่านไอเท็มเอง ไม่ใช่แค่ผ่านการพึ่งพาที่ชัดเจน | ลบการพึ่งพาหนึ่งตัวเพื่อให้ลําดับไหลไปในทิศทางเดียว |
| ชื่อซ้ํา | สองกลุ่มใช้ชื่อเดียวกัน หรือสองการกระทําภายในกลุ่มเดียวกันใช้ชื่อเดียวกัน | เปลี่ยนชื่อหนึ่งในนั้น ชื่อจะถูกเปรียบเทียบโดยไม่สนใจตัวพิมพ์เล็ก-ใหญ่ |
| การพึ่งพาไม่มีอยู่จริง | dependency ระบุชื่อกลุ่มหรือการกระทําที่ไม่ได้อยู่ในแผน | แก้ไขชื่อ หรือเพิ่มกลุ่มหรือการกระทําที่ขาดหายไป |
| การพึ่งพาตนเอง | กลุ่มหรือการกระทําขึ้นอยู่กับตัวเอง หรือการดําเนินการก่อนการปรับใช้จะมุ่งเป้าไปที่ไอเท็มของกลุ่มตัวเอง | ลบการพึ่งพา |
| การดําเนินการก่อนการปรับใช้ขึ้นอยู่กับการดําเนินการหลังการปรับใช้ | การดําเนินการก่อนปรับใช้จะทํางานก่อนที่รายการจะถูกปรับใช้ และการดําเนินการหลังการปรับใช้จะทํางานหลังจากนั้น ดังนั้นลําดับนี้จึงไม่สามารถปฏิบัติตามได้ | ย้ายการดําเนินการ หรือลบการขึ้นกับกัน |
| ตัวระบุไม่ถูกต้อง | การอ้างอิงรายการไม่ใช่ GUID ที่ถูกต้องและไม่ว่างเปล่า | แก้ไขการอ้างอิง |
| รายการหนึ่งปรากฏในมากกว่าหนึ่งกลุ่ม | แต่ละรายการสามารถเป็นของกลุ่มเดียวในแผนได้เท่านั้น | ลบสําเนา |
| เกินขีดจํากัด | แผนงานมีขนาดใหญ่กว่าที่สคีมาอนุญาต | แบ่งงานออกเป็นหลายแผน ดูข้อ ควรพิจารณาและข้อจํากัด สําหรับข้อจํากัดขนาด |
ในแคนวาส การบันทึกจะยังคงถูกปิดใช้งานจนกว่าทุกข้อผิดพลาดเหล่านี้จะได้รับการแก้ไข และองค์ประกอบที่ทําให้เกิดข้อผิดพลาดแต่ละตัวจะถูกทําเครื่องหมาย
แผนสามารถบันทึกได้ แต่จะแสดงคําเตือน
ปัญหาเหล่านี้ขึ้นอยู่กับพื้นที่ทํางานที่แผนงานชี้ไป ไม่ใช่ที่แผนงานเอง คุณสามารถบันทึกแผนและแก้ไขทีหลังได้ ซึ่งช่วยให้คุณสร้างเสร็จก่อนที่ทุกรายการจะอยู่ในพื้นที่ทํางานเป้าหมาย
| Warning | สาเหตุ | ความละเอียด |
|---|---|---|
| ไม่พบสินค้า | แผนงานอ้างอิงรายการที่ไม่มีอยู่ในพื้นที่ทํางานเป้าหมาย | ปรับใช้รายการ หรือลบการอ้างอิงออกจากแผน |
| ไม่สามารถเรียกใช้ไอเท็มได้ | รายการที่อ้างอิงมีอยู่แต่ไม่สามารถรันได้ เนื่องจากถูกลบ ปิดใช้งาน หรือเป็นประเภทที่แตกต่างจากที่การดําเนินการคาดหวัง | กู้คืนรายการ หรือชี้การดําเนินการไปยังรายการที่ถูกต้อง |
| ประเภทการกระทําที่ไม่ทราบ | แอ็กชันอ้างอิงประเภทแอ็กชันที่ไม่ได้รับการสนับสนุน | เปลี่ยนการกระทําเป็นหนึ่งใน ประเภทการกระทําที่รองรับ |
| ไม่มีสิทธิ์ในรายการที่อ้างอิง | คุณไม่มีสิทธิ์ในรายการที่แผนอ้างอิง | คุณจะได้รับคําเตือนนี้เฉพาะสําหรับรายการใน workspace อื่นเท่านั้น ขอสิทธิ์เข้าถึงรายการ หรือลบการอ้างอิง |
Note
คําเตือนไม่ได้หยุดคุณจากการเก็บแผน และไม่ได้หยุดแผนการถูกแนบมา นี่เป็นสัญญาณว่าแผนยังไม่พร้อมสําหรับพื้นที่ทํางานที่คุณชี้ไป
ปัญหาระหว่างการปฏิบัติงาน
เมื่อแผนถูกแนบแล้ว เอนจินการปรับใช้จะใช้แผนนั้นเพื่อกําหนดลําดับการวางและการดําเนินการที่จะทํางาน ความล้มเหลวในขั้นตอนนี้จะถูกรายงานในขั้นตอนการปฏิบัติงาน ไม่ใช่ในแผน
การปฏิบัติการหยุดกลางคัน
เมื่อการดําเนินการล้มเหลว การปรับใช้จะหยุดลง รายการที่ติดตั้งไปแล้วจะยังคงอยู่ในพื้นที่ทํางานเป้าหมาย และรายการที่มาทีหลังในลําดับจะไม่ถูกติดตั้ง
การปรับใช้ที่ล้มเหลวจะไม่ย้อนกลับการปรับใช้รายการที่เสร็จสมบูรณ์หรือการเปลี่ยนแปลงที่เกิดจากการกระทํา ก่อนลองใหม่ ให้ระบุว่าอะไรสําเร็จและแก้ไขสาเหตุของความล้มเหลว ตรวจสอบว่าการดําเนินการซ้ําที่เสร็จสมบูรณ์อาจทําให้ข้อมูลซ้ําหรือเกิดการเปลี่ยนแปลงที่ไม่ตั้งใจได้หรือไม่ ทําตามขั้นตอนกู้คืนสําหรับเครื่องมือปรับใช้ที่คุณใช้
การดําเนินการล้มเหลว
แอคชั่นเป็นการวิ่งไอเท็ม Fabric ปกติ ดังนั้นรายละเอียดความล้มเหลวจะอยู่กับไอเท็ม ไม่ใช่กับแผน การปรับใช้รายงานข้อผิดพลาดที่ระบุการดําเนินการที่ล้มเหลว หากต้องการทราบสาเหตุที่ล้มเหลว ให้เปิดรายการนั้นและตรวจสอบประวัติการรันของมัน
การดําเนินการล้มเหลวเนื่องจากพื้นที่ทํางานไม่ได้กําหนดค่า
การปรับใช้จะมีการกําหนดรายการ มันไม่มีการตั้งค่าพื้นที่ทํางาน และแผนงานก็ไม่มีเช่นกัน เมื่อคุณปรับใช้ในพื้นที่ทํางานเป็นครั้งแรก เช่น พื้นที่ทํางานที่แยกสาขาใหม่หรือขั้นตอน pipeline ที่เพิ่งสร้างขึ้น พื้นที่ทํางานเป้าหมายจะเริ่มต้นด้วยการตั้งค่าเริ่มต้น
สิ่งนี้สําคัญกับแผนมากกว่าไม่มีแผน เพราะการกระทําของแผนจะทํางานกับพื้นที่ทํางานเป้าหมายทันทีหลังจากที่รายการถูกติดตั้ง ไอเท็มเองจะถูกปล่อยออกมาอย่างถูกต้อง แต่การดําเนินการแรกล้มเหลว
| อาการ | สาเหตุ | ความละเอียด |
|---|---|---|
| การดําเนินการไม่สามารถอ่านหรือเขียนข้อมูลได้ หรือการตรวจสอบสิทธิ์ล้มเหลว | พื้นที่ทํางานเป้าหมายไม่มีตัวตนของพื้นที่ทํางาน ดังนั้นรายการที่พึ่งพาพื้นที่ทํางานนั้นจึงไม่มีตัวตนสําหรับการตรวจสอบสิทธิ์ | สร้างตัวตนของพื้นที่ทํางานในพื้นที่ทํางานเป้าหมาย จากนั้นให้สิทธิ์เข้าถึงแหล่งข้อมูล |
| เซสชัน Spark ไม่เริ่ม หรือเริ่มด้วยการตั้งค่าที่ไม่คาดคิด | การตั้งค่า Spark, พูลที่กําหนดเอง และสภาพแวดล้อมเริ่มต้นเป็นการตั้งค่าพื้นที่ทํางานและไม่ได้ถูกนําไปใช้งาน | กําหนดค่าการตั้งค่า Spark บนพื้นที่ทํางานเป้าหมายให้ตรงกับแหล่งที่มาก่อนที่คุณจะปรับใช้ |
| การดําเนินการไม่สามารถเข้าถึงแหล่งข้อมูลที่ทํางานในพื้นที่ทํางานต้นทางได้ | การเชื่อมต่อและการผูกกับเกตเวย์เป็นระดับพื้นที่ทํางานและไม่ได้ถูกนําไปใช้งาน | สร้างการเชื่อมต่อใหม่ในพื้นที่ทํางานเป้าหมาย |
กําหนดค่าการตั้งค่าเหล่านี้บนพื้นที่ทํางานเป้าหมายก่อนการปรับใช้ครั้งแรก เมื่อกําหนดค่าแล้ว ระบบจะคงอยู่ ดังนั้นการติดตั้งในภายหลังไปยังพื้นที่ทํางานเดียวกันจะไม่ได้รับผลกระทบ
การอ้างอิงระหว่างรายการเป็นเรื่องแยกต่างหาก บางตัวจะรีบันไดอัตโนมัติเมื่อมีไอเท็มถูกปล่อย และบางตัวไม่ ซึ่งเปลี่ยนสิ่งที่การกระทําจะพบเมื่อทํางาน สําหรับข้อมูลเพิ่มเติม โปรดดูทําความเข้าใจการผูกการอ้างอิงในการปรับใช้ข้ามพื้นที่ทํางาน
การกระทําถัดไปเริ่มเร็วเกินไป
การดําเนินการจะเสร็จสิ้นเมื่อการรันของไอเท็มสิ้นสุดลง มันไม่รอให้บริการปลายทางตามทัน ดังนั้นข้อมูลที่การกระทําสร้างขึ้นอาจไม่สามารถสอบถามได้เมื่อการดําเนินการถัดไปเริ่มขึ้น
ถ้าการกระทําในภายหลังขึ้นอยู่กับข้อมูลนั้น ให้แน่ใจว่ามันขึ้นอยู่กับการกระทําที่สร้างข้อมูลอย่างชัดเจน หากการพึ่งพามีอยู่แล้ว ให้เพิ่มการตรวจสอบความพร้อมให้กับการกระทําที่ผลิต หรือย้ายงานที่ขึ้นกับไปยังการกระทําเดียวกัน
การดําเนินการ Dataflow Gen2 ล้มเหลวในเหตุการณ์ที่สอง
รายการ Dataflow Gen2 เดียวกันไม่สามารถปรากฏสองครั้งในแผนเดียวกันได้ เพราะงานรีเฟรชไม่สามารถรันได้มากกว่าหนึ่งครั้งพร้อมกัน แคนวาสจะเตือนคุณเมื่อคุณเพิ่มเหตุการณ์ที่สอง และเหตุการณ์ที่สองจะถูกบล็อกเมื่อการปรับใช้ทํางาน
ลบการกระทําซ้ํา
ผลลัพธ์ของฟังก์ชันข้อมูลผู้ใช้ไม่สมบูรณ์
เอาต์พุตที่มีขนาดใหญ่กว่า 512 KB จะถูกตัดทอน การปฏิบัติการยังคงประสบความสําเร็จ ดังนั้นการส่งกําลังจึงดําเนินต่อไป ถ้าคุณต้องการผลลัพธ์เต็ม ให้เขียนข้อมูลนั้นลงใน storage จากภายในฟังก์ชันแทนที่จะส่งคืน
แผนไม่ได้อยู่ในเครื่องเลือก
ตัวเลือกบนแต่ละพื้นผิวที่แนบจะแสดงแผนผังที่คุณสามารถเข้าถึงได้ หากแผนขาดหายไป:
- ยืนยันว่าประเภทแผนการปรับใช้ถูกเปิดใช้งานแล้ว ดูที่ สร้างแผนการปรับใช้
- ยืนยันว่าคุณมีบทบาทผู้มีส่วนร่วมอย่างน้อยบน workspace ที่ถือแผนงาน ดูสิทธิ์แผนการปรับใช้
- ยืนยันว่าแผนถูกบันทึกไว้แล้ว