แชร์ผ่าน


ตัวควบคุมแหล่งข้อมูลและการปรับใช้ฟังก์ชันข้อมูลผู้ใช้

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

เรียนรู้เพิ่มเติมเกี่ยวกับกระบวนการรวม Git กับพื้นที่ทํางานของ Microsoft Fabric ของคุณใน แนวคิดพื้นฐานในการรวม Git

ตั้งค่าการเชื่อมต่อ

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

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

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

การแสดงฟังก์ชันข้อมูลผู้ใช้ใน Git

รูปภาพต่อไปนี้แสดงตัวอย่างโครงสร้างไฟล์ของแต่ละรายการฟังก์ชันข้อมูลผู้ใช้ในที่เก็บ

สกรีนช็อตแสดงโครงสร้างโฟลเดอร์สําหรับรายการฟังก์ชันข้อมูลผู้ใช้ในที่เก็บ

โครงสร้างโฟลเดอร์ประกอบด้วยองค์ประกอบต่อไปนี้:

  • แพลตฟอร์ม : แฟ้ม .platform มีแอตทริบิวต์ต่อไปนี้:

    สกรีนช็อตที่แสดงไฟล์แพลตฟอร์มสําหรับรายการฟังก์ชันข้อมูลผู้ใช้

    • เวอร์ชัน: หมายเลขเวอร์ชันของไฟล์ระบบ หมายเลขนี้ใช้เพื่อเปิดใช้งานความเข้ากันได้ย้อนหลัง หมายเลขเวอร์ชันของสินค้าอาจแตกต่างกัน
    • logicalId: ตัวระบุพื้นที่ทํางานข้ามที่สร้างขึ้นโดยอัตโนมัติที่แสดงถึงรายการและการแสดงตัวควบคุมแหล่งข้อมูล
    • ชนิด: UserDataFunction คือชนิดที่กําหนดรายการฟังก์ชันข้อมูลผู้ใช้
    • displayName: แสดงชื่อของรายการ เมื่อมีการเปลี่ยนชื่อรายการฟังก์ชันข้อมูลผู้ใช้ displayName นี้จะถูกอัปเดต
  • definitions.json: ไฟล์นี้ใช้ข้อกําหนดรายการฟังก์ชันข้อมูลผู้ใช้ทั้งหมดร่วมกัน เช่น การเชื่อมต่อ ไลบรารี และอื่น ๆ เป็นตัวแทนของคุณสมบัติรายการฟังก์ชันข้อมูลผู้ใช้

    สกรีนช็อตที่แสดงไฟล์ definitions.json สําหรับรายการฟังก์ชันข้อมูลผู้ใช้

  • function-app.py: ไฟล์นี้คือโค้ดฟังก์ชันของคุณ การเปลี่ยนแปลงรหัสใด ๆ ที่คุณทํากับรายการฟังก์ชันข้อมูลผู้ใช้จะถูกซิงค์ลงใน repo กับไฟล์นี้ คุณสามารถดําเนินการ Git ต่าง ๆ เพื่อจัดการวงจรการพัฒนาโค้ด

    สกรีนช็อตที่แสดงไฟล์ function-app.py สําหรับรายการฟังก์ชันข้อมูลผู้ใช้

  • ทรัพยากร: โฟลเดอร์ประกอบด้วยไฟล์ functions.json ที่มีเมตาดาต้าทั้งหมด เช่น การเชื่อมต่อ ไลบรารี และฟังก์ชันภายในรายการนี้ ไม่ต้องปรับปรุงแฟ้มนี้ ด้วยตนเอง functions.json อนุญาตให้ Fabric สร้างหรือสร้างรายการฟังก์ชันข้อมูลผู้ใช้ในพื้นที่ทํางานใหม่ได้

    สกรีนช็อตที่แสดงไฟล์ function.json ในโฟลเดอร์ทรัพยากรสําหรับรายการฟังก์ชันข้อมูลผู้ใช้

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการรวม Git รวมถึงรายละเอียดเกี่ยวกับโครงสร้างโฟลเดอร์และไฟล์ระบบ โปรดดู รูปแบบซอร์สโค้ดการรวม Git

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

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

โน้ต

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

เมื่อต้องการปรับใช้ฟังก์ชันข้อมูลผู้ใช้ของคุณโดยใช้ไปป์ไลน์การปรับใช้:

  1. สร้างไปป์ไลน์การปรับใช้งานใหม่หรือเปิดไปป์ไลน์การปรับใช้งานที่มีอยู่ ดู เริ่มต้นใช้งาน ไปป์ไลน์การปรับใช้ สําหรับข้อมูลเพิ่มเติม

  2. กําหนดพื้นที่ทํางานให้กับขั้นตอนที่แตกต่างกันตามเป้าหมายการปรับใช้ของคุณ

  3. เลือก ดู และเปรียบเทียบรายการรวมถึงรายการฟังก์ชันข้อมูลผู้ใช้ระหว่างขั้นตอนต่างๆ

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

  5. ตรวจสอบสถานะการปรับใช้จาก ประวัติการปรับใช้