แชร์ผ่าน

การรวม Microsoft Fabric Git คืออะไร

  • บทความ

บทความนี้อธิบายวิธีการรวมการควบคุมเวอร์ชัน Git เข้ากับเครื่องมือการจัดการวงจรชีวิตแอปพลิเคชัน Microsoft Fabric (ALM) สําหรับนักพัฒนา

หมายเหตุ

บางรายการสําหรับการรวม Git อยู่ในตัวอย่าง สําหรับข้อมูลเพิ่มเติม ดูรายการ หน่วยข้อมูลที่สนับสนุน

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

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

ดูรายการ ที่รองรับ

  • อ่านเพิ่มเติมเกี่ยวกับแนวคิด ควบคุมเวอร์ชัน Git Git พื้นฐานและ

  • อ่านเพิ่มเติมเกี่ยวกับกระบวนการรวม Git

  • อ่านเกี่ยวกับวิธีที่ดีที่สุดในการจัดการสาขา Git ของคุณ

ข้อมูลความเป็นส่วนตัว

ก่อนที่คุณจะเปิดใช้งานการรวม Git ตรวจสอบให้แน่ใจว่าคุณได้ตรวจทานนโยบายความเป็นส่วนตัวต่อไปนี้:

ผู้ให้บริการ Git ที่สนับสนุน

ผู้ให้บริการ Git ต่อไปนี้ได้รับการสนับสนุน:

  • Git ในที่เก็บ Azure ที่มี ผู้เช่า เดียวกันเป็นผู้เช่า Fabric
  • GitHub (เฉพาะเวอร์ชันคลาวด์เท่านั้น)
  • GitHub Enterprise (เฉพาะเวอร์ชันระบบคลาวด์เท่านั้น)

รายการที่สนับสนุน

รายการต่อไปนี้ได้รับการรองรับในขณะนี้:

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

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

ข้อจํากัดการรวม Git ทั่วไป

  • วิธีการรับรองความถูกต้องใน Fabric ต้องมีความแข็งแกร่งเป็นวิธีการรับรองความถูกต้องสําหรับ Git อย่างน้อย ตัวอย่างเช่น ถ้า Git ต้องการการรับรองความถูกต้องแบบหลายปัจจัย Fabric จําเป็นต้องรับรองความถูกต้องแบบหลายปัจจัยเช่นกัน
  • ชุดข้อมูล Power BI ที่เชื่อมต่อกับ Analysis Services ไม่ได้รับการสนับสนุนในขณะนี้
  • พื้นที่ทํางานที่ติดตั้งแอปเทมเพลตจะไม่สามารถเชื่อมต่อกับ Git ได้
  • ระบบไม่รองรับแบบจําลองย่อย
  • ไม่รองรับบริการคลาวด์แบบ Sovereign
  • บัญชี Azure DevOps ต้องลงทะเบียนกับผู้ใช้เดียวกันกับที่ใช้พื้นที่ทํางาน Fabric
  • Azure DevOps ไม่ได้รับการสนับสนุนหากเปิดใช้งานการตรวจสอบความถูกต้องของนโยบายการเข้าถึงแบบมีเงื่อนไขของ azure เปิดใช้งาน
  • ผู้ดูแลระบบผู้เช่าต้องเปิดใช้งาน การส่งออก ทางภูมิศาสตร์ข้ามหากพื้นที่ทํางานและ Git repo อยู่ในสองภูมิภาคทางภูมิศาสตร์ที่แตกต่างกัน
  • ถ้าองค์กรของคุณกําหนดค่า การเข้าถึงแบบมีเงื่อนไขตรวจสอบให้แน่ใจว่า บริการของ Power BI มีเงื่อนไข เดียวกันกับที่ตั้งค่า สําหรับการรับรองความถูกต้องเพื่อให้ทํางานตามที่คาดไว้
  • ขนาดการยอมรับถูกจํากัดไว้ที่ 125 MB

ข้อจํากัดของ GitHub Enterprise

ไม่รองรับการตั้งค่า GitHub Enterprise บางรายการ ตัวอย่างเช่น:

ข้อจํากัดของพื้นที่ทํางาน

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

ข้อจํากัดสาขาและโฟลเดอร์

  • ความยาวสูงสุดของชื่อสาขาคือ 244 อักขระ
  • ความยาวสูงสุดของเส้นทางแบบเต็มสําหรับชื่อแฟ้มคือ 250 อักขระ ชื่อที่ยาวขึ้นล้มเหลว
  • ขนาดไฟล์สูงสุดคือ 25 MB
  • โครงสร้างโฟลเดอร์ถูกเก็บไว้ลึกถึง 10 ระดับ
  • คุณไม่สามารถดาวน์โหลดรายงาน/ชุดข้อมูลเป็น .pbix จากบริการหลังจากปรับใช้ด้วยการรวม Git
  • หากชื่อที่แสดงของรายการมีลักษณะใด ๆ เหล่านี้ โฟลเดอร์ Git จะถูกเปลี่ยนชื่อเป็น ID เชิงตรรกะ (Guid) และชนิด:
    • มีอักขระมากกว่า 256 ตัว
    • ลงท้ายด้วย หรือช่องว่าง
    • ประกอบด้วยอักขระห้ามใช้งานตามที่อธิบายไว้ในข้อจํากัดชื่อไดเรกทอรี
  • เมื่อคุณเชื่อมต่อพื้นที่ทํางานที่มีโฟลเดอร์กับ Git คุณจําเป็นต้องบันทึกการเปลี่ยนแปลง Git repo หากโครงสร้างโฟลเดอร์ แตกต่างกัน

ข้อจํากัดของชื่อไดเรกทอรี

  • ชื่อของไดเรกทอรีที่เชื่อมต่อกับที่เก็บ Git มีข้อจํากัดในการตั้งชื่อดังต่อไปนี้:

    • ชื่อไดเรกทอรีไม่สามารถเริ่มต้นหรือลงท้ายด้วยช่องว่างหรือแท็บ
    • ชื่อไดเรกทอรีไม่สามารถมีอักขระใดๆ ต่อไปนี้: "/:<>\*?|

  • โฟลเดอร์รายการ (โฟลเดอร์ที่มีแฟ้มรายการ) ไม่สามารถมีอักขระใด ๆ ต่อไปนี้ได้: ":<>\*?| ถ้าคุณเปลี่ยนชื่อโฟลเดอร์เป็นอักขระใดอักขระหนึ่งที่มีอักขระเหล่านี้ Git จะไม่สามารถเชื่อมต่อหรือซิงค์กับพื้นที่ทํางานและจะเกิดข้อผิดพลาดขึ้นได้

การแตกสาขาออกข้อจํากัด

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

ขีดจํากัดการซิงค์และยอมรับ

  • คุณสามารถซิงค์ได้ครั้งละหนึ่งทิศทางเท่านั้น คุณไม่สามารถยอมรับและอัปเดตในเวลาเดียวกันได้
  • ป้ายชื่อระดับความลับไม่ได้รับการสนับสนุนและการส่งออกรายการที่มีป้ายชื่อระดับความลับอาจถูกปิดใช้งาน หากต้องการยอมรับรายการที่มีป้ายชื่อระดับความลับโดยไม่มีป้ายชื่อระดับความลับ โปรด ขอความช่วยเหลือจากผู้ดูแลระบบ ของคุณ
  • ทํางานกับ รายการที่จํากัด รายการที่ไม่ได้รับการรองรับในโฟลเดอร์จะถูกละเว้น
  • ไม่อนุญาตให้ใช้ชื่อการทําซ้ํา แม้ว่า Power BI จะอนุญาตให้ทําซ้ําชื่อ การอัปเดต ยอมรับ หรือยกเลิกการดําเนินการจะล้มเหลว
  • ไม่รองรับ B2B
  • การแก้ปัญหา ความขัดแย้งจะทําบางส่วนใน Git
  • ในระหว่างกระบวนการการยอมรับไปยัง Git บริการ Fabric จะลบไฟล์ภายในโฟลเดอร์รายการที่ไม่ใช่ส่วนหนึ่งของข้อกําหนดรายการ แฟ้มที่ไม่เกี่ยวข้องที่ไม่อยู่ในโฟลเดอร์รายการจะไม่ถูกลบออก
  • หลังจากที่คุณบันทึกการเปลี่ยนแปลงคุณอาจสังเกตเห็นการเปลี่ยนแปลงที่ไม่คาดคิดบางอย่างไปยังรายการที่คุณไม่ได้ทํา การเปลี่ยนแปลงเหล่านี้ไม่มีนัยสําคัญทางความหมายและสามารถเกิดขึ้นได้ด้วยเหตุผลหลายประการ ตัวอย่าง:
    • การเปลี่ยนแปลงแฟ้มข้อกําหนดหน่วยข้อมูลด้วยตนเอง การเปลี่ยนแปลงเหล่านี้ถูกต้อง แต่อาจแตกต่างจากถ้าทําผ่านตัวแก้ไข ตัวอย่างเช่น ถ้าคุณเปลี่ยนชื่อคอลัมน์แบบจําลองความหมายใน Git และนําเข้าการเปลี่ยนแปลงนี้ไปยังพื้นที่ทํางาน ในครั้งถัดไปที่คุณยอมรับการเปลี่ยนแปลงไปยังแบบจําลอง ความหมาย ไฟล์ bim จะลงทะเบียนเป็นการเปลี่ยนแปลงและคอลัมน์ที่ปรับเปลี่ยนแล้วจะถูกส่งไปยังด้านหลังของ columns อาร์เรย์ ทั้งนี้เนื่องจากกลไก AS ที่สร้าง ไฟล์ bim จะส่งคอลัมน์ที่เปลี่ยนชื่อไปยังส่วนท้ายของอาร์เรย์ การเปลี่ยนแปลงนี้จะไม่มีผลต่อวิธีดําเนินการของรายการ
    • บันทึกไฟล์ที่ใช้ตัวแบ่งบรรทัด CRLF บริการนี้ใช้ ตัวแบ่งบรรทัด LF (ตัวดึงข้อมูลบรรทัด) หากคุณมีไฟล์รายการใน Git repo ที่มีตัวแบ่งบรรทัด CRLF เมื่อคุณยอมรับจากบริการไฟล์เหล่านี้จะเปลี่ยนเป็น LF ตัวอย่างเช่น ถ้าคุณเปิดรายงานในเดสก์ท็อป ให้บันทึกไฟล์โครงการ (.pbip) และอัปโหลดไปยัง Git โดยใช้ CRLF
  • การรีเฟรชแบบจําลองความหมายโดยใช้ API การรีเฟรชที่ปรับปรุงแล้วจะทําให้เกิด Git diff หลังจากการรีเฟรชแต่ละครั้ง

เนื้อหาที่เกี่ยวข้อง