หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เรียนรู้วิธีการรวม Git และไปป์ไลน์การปรับใช้ทํางานกับ API สําหรับ GraphQL ใน Microsoft Fabric บทความนี้ช่วยให้คุณเข้าใจวิธีการตั้งค่าการเชื่อมต่อกับที่เก็บของคุณ จัดการ API สําหรับ GraphQL และปรับใช้กับสภาพแวดล้อมต่าง ๆ
หมายเหตุ
API สําหรับตัวควบคุมแหล่งข้อมูล GraphQL และการปรับใช้อยู่ใน ตัวอย่างในขณะนี้
ข้อกําหนดเบื้องต้น
- คุณต้องมี API สําหรับ GraphQL ใน Fabric สําหรับข้อมูลเพิ่มเติม ดู สร้าง API สําหรับ GraphQL ใน Fabric และเพิ่มข้อมูล
ภาพรวม
ผ้ามีเครื่องมือที่มีประสิทธิภาพสําหรับ CI/CD (การรวมอย่างต่อเนื่องและการปรับใช้อย่างต่อเนื่อง) และการจัดการวงจรชีวิตการพัฒนาผ่านสองคอมโพเนนต์หลัก: การรวม Git (CI) และ ไปป์ไลน์การปรับใช้ (CD) พื้นที่ทํางานทําหน้าที่เป็นองค์ประกอบส่วนกลางสําหรับทั้งขั้นตอนการซิงโครไนซ์ Git และการปรับใช้
การรวม Git (CI): ซิงโครไนซ์รายการพื้นที่ทํางาน (เช่น โค้ด การกําหนดค่า API) ด้วย ที่เก็บการควบคุมเวอร์ชัน การเปิดใช้งานการควบคุมเวอร์ชันและการติดตามการเปลี่ยนแปลงผ่าน Git
ไปป์ไลน์การปรับใช้ (CD): เปิดใช้งานการสร้างขั้นตอน (เช่น การพัฒนา การทดสอบ การผลิต) ด้วยพื้นที่ทํางานที่เชื่อมโยง รายการที่สนับสนุนในแต่ละขั้นตอนจะถูกจําลองไปยังขั้นตอนต่อไปโดยอัตโนมัติ และการเปลี่ยนแปลงในการปรับใช้ทริกเกอร์พื้นที่ทํางานในไปป์ไลน์การเผยแพร่ คุณสามารถกําหนดค่าไปป์ไลน์เพื่อให้แน่ใจว่ามีการทดสอบและปรับใช้การเปลี่ยนแปลงอย่างมีประสิทธิภาพทั่วทั้งสภาพแวดล้อม
Fabric สนับสนุนเวิร์กโฟลว์ CI/CD ต่าง ๆ ที่ปรับให้เข้ากับสถานการณ์ทั่วไป สําหรับรายละเอียดเพิ่มเติม ดูตัวเลือกเวิร์กโฟลว์ CI/CD ใน Fabric
หมายเหตุ
เฉพาะเมตาดาต้าเท่านั้นที่จะถูกคัดลอกในระหว่างการปรับใช้ และ ไม่มีการคัดลอกข้อมูล
รายการจากพื้นที่ทํางานจะถูกจัดเก็บไว้ในที่เก็บ Git ที่เกี่ยวข้องเป็นโครงสร้างพื้นฐานเป็นโค้ด (IaC) การเปลี่ยนแปลงรหัสในที่เก็บสามารถทริกเกอร์การปรับใช้ในไปป์ไลน์ได้ วิธีนี้ช่วยให้คุณมีการเปลี่ยนแปลงโค้ดโดยอัตโนมัติที่ทําซ้ําในขั้นตอนต่างๆ สําหรับการทดสอบและเผยแพร่การผลิต
วิธีการรับรองความถูกต้องแหล่งข้อมูล
ในส่วนนี้ คุณเรียนรู้เกี่ยวกับวิธีการรับรองความถูกต้องเพื่อเชื่อมต่อแหล่งข้อมูลกับ API ของคุณสําหรับ GraphQL และทําความเข้าใจผลกระทบของพวกเขาต่อการผูกโดยอัตโนมัติระหว่าง API สําหรับ GraphQL และแหล่งข้อมูลที่เชื่อมต่อในไปป์ไลน์การพัฒนา คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับ autobinding ในกระบวนการไปป์ไลน์การปรับใช้ได้
มีตัวเลือกสองตัวเลือกในการเชื่อมต่อแหล่งข้อมูลกับ API ของคุณสําหรับ GraphQL:
เชื่อมต่อกับแหล่งข้อมูล Fabric ด้วยการรับรองความถูกต้องแบบลงชื่อเข้าระบบครั้งเดียว (SSO)
เชื่อมต่อกับ Fabric หรือแหล่งข้อมูลภายนอกโดยใช้ข้อมูลประจําตัวที่บันทึกไว้
ตัวเลือกแรก Sign-On เดียว (SSO) เปิดใช้งานการเชื่อมต่อกับแหล่งข้อมูลภายใน Fabric ในกรณีนี้ เมื่อคุณเชื่อมต่อแหล่งข้อมูลกับ GraphQL โดยใช้วิธีการลงชื่อเข้าระบบครั้งเดียวในพื้นที่ทํางานเดิม (ตัวอย่างเช่น ขั้นตอน Dev) แหล่งข้อมูลและรายการ GraphQL จะถูกปรับใช้กับพื้นที่ทํางานเป้าหมาย (ตัวอย่างเช่น ขั้นตอนการทดสอบ) ในไปป์ไลน์ และ GraphQL ในพื้นที่ทํางานเป้าหมายจะถูกเชื่อมต่อกับแหล่งข้อมูลภายในเครื่องที่ปรับใช้ในพื้นที่ทํางานเป้าหมายโดยอัตโนมัติ (ดูแผนภาพด้านล่าง) มีข้อจํากัดเฉพาะเมื่อใช้ SSO และเชื่อมต่อกับแหล่งข้อมูลผ่านจุดสิ้นสุด SQL Analytics สําหรับรายละเอียดเพิ่มเติม โปรดดูที่ **ข้อจํากัดปัจจุบัน
ตัวเลือกที่สอง ข้อมูลประจําตัวที่บันทึกไว้ เปิดใช้งานการเชื่อมต่อกับแหล่งข้อมูลภายนอกภายนอก Fabric และแหล่งข้อมูลภายใน Fabric อย่างไรก็ตาม การผูกอัตโนมัติ ไม่ได้รับการสนับสนุนสําหรับวิธีข้อมูลประจําตัวที่บันทึกไว้ ซึ่งหมายความว่าถ้าคุณเชื่อมต่อแหล่งข้อมูลกับ GraphQL โดยใช้ข้อมูลประจําตัวที่บันทึกไว้ในพื้นที่ทํางานเดิม (ขั้นตอน Dev) แหล่งข้อมูลจะถูกปรับใช้กับพื้นที่ทํางานเป้าหมาย (ขั้นตอนการทดสอบ) ในไปป์ไลน์ อย่างไรก็ตาม รายการ GraphQL ในพื้นที่ทํางานเป้าหมายจะยังคงเชื่อมต่อกับแหล่งข้อมูลในพื้นที่ทํางานดั้งเดิม (ขั้นตอน Dev) ผ่านข้อมูลประจําตัวที่บันทึกไว้ แทนที่จะผูกกับแหล่งข้อมูลภายในเครื่องในพื้นที่ทํางานเป้าหมายโดยอัตโนมัติ (ดูไดอะแกรมด้านล่าง)
นอกจากนี้ หากมีการใช้วิธีการ ข้อมูลประจําตัวที่บันทึกไว้ เพื่อเชื่อมต่อกับแหล่งข้อมูล นักพัฒนาต้องมีสิทธิ์ในการเข้าถึงข้อมูลข้อมูลประจําตัวที่บันทึกไว้เพื่อปรับใช้รายการ GraphQL ได้สําเร็จ
หมายเหตุ
ถ้า API สําหรับ GraphQL ในพื้นที่ทํางานต้นฉบับ (ขั้นตอน Dev) เชื่อมต่อกับแหล่งข้อมูลที่อยู่ในพื้นที่ทํางานอื่น API ที่ปรับใช้สําหรับ GraphQL ในพื้นที่ทํางานเป้าหมาย (ขั้นตอนการทดสอบ) จะยังคงเชื่อมต่อกับแหล่งข้อมูลที่อยู่ในพื้นที่ทํางานที่แตกต่างกันโดยไม่คํานึงถึงวิธีการรับรองความถูกต้องที่ใช้เพื่อเชื่อมต่อแหล่งข้อมูลกับ API สําหรับ GraphQL ของคุณ (ดูไดอะแกรมด้านล่าง)
API สําหรับการรวม GraphQL Git
Fabric API สําหรับ GraphQL เสนอการรวม Git สําหรับตัวควบคุมแหล่งข้อมูล ด้วยการรวม Git คุณสามารถสํารองและเวอร์ชัน API ของคุณสําหรับ GraphQL แปลงกลับเป็นขั้นตอนก่อนหน้าที่จําเป็น ทํางานร่วมกัน หรือทํางานเพียงอย่างเดียวโดยใช้ สาขา Git และจัดการ API ของคุณสําหรับวงจรชีวิต GraphQL ทั้งหมดภายใน Fabric
ตั้งค่าการเชื่อมต่อ:
จาก การตั้งค่าพื้นที่ทํางานของคุณ คุณสามารถตั้งค่าการเชื่อมต่อไปยัง repo ของคุณเพื่อบันทึกและซิงค์การเปลี่ยนแปลงได้อย่างง่ายดาย หากต้องการตั้งค่าการเชื่อมต่อ โปรดดู เริ่มต้นใช้งานการรวมกันของ Git เมื่อเชื่อมต่อแล้ว รายการของคุณรวมถึง API สําหรับ GraphQL จะปรากฏในแผงควบคุมแหล่งข้อมูล
หลังจากที่คุณยอมรับ API สําหรับอินสแตนซ์ GraphQL ไปยังที่เก็บ Git เรียบร้อยแล้ว คุณจะเห็นโครงสร้างโฟลเดอร์ GraphQL ใน repo ขณะนี้คุณสามารถดําเนินการในอนาคตได้ เช่น สร้างคําขอดึงข้อมูล
การแสดง GraphQL ใน Git:
รูปภาพต่อไปนี้เป็นตัวอย่างของโครงสร้างไฟล์ของแต่ละ API สําหรับรายการ GraphQL ใน Git repo:
เมื่อคุณยืนยัน API สําหรับรายการ GraphQL ไปยังที่เก็บ Git API สําหรับข้อกําหนด GraphQL จะถูกจัดเก็บไว้ วิธีการนี้สนับสนุนการกู้คืนที่แม่นยําเมื่อคุณซิงค์กลับไปยังพื้นที่ทํางาน Fabric:
คุณสามารถค้นหาข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบคําจํากัดความ ไวยากรณ์ และตัวอย่าง GraphQL API ได้ในเอกสารประกอบ API ระนาบควบคุม Fabric:
API สําหรับ GraphQL ในไปป์ไลน์การปรับใช้
ใช้ขั้นตอนต่อไปนี้เพื่อดําเนินการ API ของคุณสําหรับการปรับใช้ GraphQL โดยใช้ไปป์ไลน์การปรับใช้
สร้างไปป์ไลน์การปรับใช้งานใหม่หรือเปิดไปป์ไลน์การปรับใช้งานที่มีอยู่ สําหรับข้อมูลเพิ่มเติม ดูเริ่มต้นใช้งานไปป์ไลน์การปรับใช้
กําหนดพื้นที่ทํางานให้กับขั้นตอนที่แตกต่างกันตามเป้าหมายการปรับใช้ของคุณ
เลือก ดู และเปรียบเทียบรายการรวมถึง API สําหรับ GraphQL ระหว่างขั้นตอนต่างๆ ดังที่แสดงในตัวอย่างต่อไปนี้ พื้นที่ที่เน้นซึ่งระบุจํานวนรายการที่เปลี่ยนแปลงระหว่างขั้นตอนก่อนหน้าและขั้นตอนปัจจุบัน
- เลือกรายการที่จําเป็นต้องปรับใช้ เลือก ปรับใช้ เพื่อปรับใช้รายการที่คุณเลือก (API สําหรับ GraphQL และแหล่งข้อมูลที่เชื่อมต่อ) ในขั้นตอน การพัฒนา การทดสอบ และการผลิต
ข้อความถัดไปจะปรากฏขึ้นเพื่อยืนยันรายการที่คุณกําลังจะปรับใช้ เลือก ปรับใช้ เพื่อยืนยันและดําเนินกระบวนการปรับใช้ต่อไป
ข้อจำกัดปัจจุบัน
Fabric CI/CD ไม่สนับสนุน การผูกอัตโนมัติ ของรายการย่อย ซึ่งหมายความว่าถ้า API สําหรับ GraphQL เชื่อมต่อกับจุดสิ้นสุดการวิเคราะห์ SQL ในฐานะรองของแหล่งข้อมูลในพื้นที่ทํางานดั้งเดิม (เช่น ขั้นตอน Dev) สายข้อมูลจะไม่ถ่ายโอนไปยังพื้นที่ทํางานเป้าหมาย (เช่น ขั้นตอนการทดสอบ) ด้วยเหตุนี้ API ที่ปรับใช้สําหรับ GraphQL ในพื้นที่ทํางานเป้าหมาย (เช่น ขั้นตอนการทดสอบ) ยังคงเชื่อมต่อกับจุดสิ้นสุดการวิเคราะห์ SQL ในพื้นที่ทํางานดั้งเดิม (เช่น ขั้นตอนการพัฒนา)
ไม่รองรับการผูกอัตโนมัติ เมื่อใช้วิธี ข้อมูลประจําตัวที่บันทึกไว้ สําหรับการเชื่อมต่อแหล่งข้อมูล สําหรับข้อมูลเพิ่มเติม โปรดดูหัวข้อ วิธีการรับรองความถูกต้องของแหล่งข้อมูล ที่อธิบายไว้ข้างต้น