แชร์ผ่าน

รูปแบบรหัสแหล่งที่มาของการรวม Git

  • บทความ

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

ชื่อไดเรกทอรี

เมื่อคุณบันทึกรายการใหม่ใน Git การรวม Git จะสร้างไดเรกทอรีสําหรับรายการนั้นโดยอัตโนมัติ

ชื่อไดเรกทอรีรายการจะเป็นไปตามกฎต่อไปนี้:

  • รูปแบบสําหรับชื่อคือ{display name}.{public facing type}
  • ถ้าจําเป็น จะทําการเปลี่ยนแปลงชื่อที่แสดงดังต่อไปนี้:
    • อักขระที่ไม่ถูกต้องจะถูกแทนที่ด้วย หมายเลข HTML
    • ช่องว่างนําหน้าจะถูกแทนที่ด้วย หมายเลข HTML
    • ช่องว่างต่อท้ายหรือจุดจะถูกแทนที่ด้วย หมายเลข HTML
  • หากชื่อโฟลเดอร์นั้นไม่พร้อมใช้งาน ชื่อของ logicalID (GUID) ของรายการจะถูกใช้แทนชื่อที่แสดง

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

สกรีนช็อตของรายการข้อมูลในพื้นที่ทํางาน Fabric

ไดเรกทอรีต่อไปนี้จะถูกสร้างขึ้นในที่เก็บ Git:

สกรีนช็อตของชื่อของไดเรกทอรี Git ที่ประกอบด้วยรายการ Fabric

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

เนื้อหาไดเรกทอรี

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

ไฟล์ข้อกําหนดหน่วยข้อมูล

ไดเรกทอรีของรายการแต่ละรายการมีไฟล์ที่จําเป็นซึ่งกําหนดรายการนั้นโดยเฉพาะ

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

ฐานข้อมูลที่มิเรอร์

โฟลเดอร์ฐานข้อมูลที่มิเรอร์ประกอบด้วยแฟ้ม .json ที่กําหนดฐานข้อมูลที่มิเรอร์

สําหรับคําแนะนําเกี่ยวกับการใช้การรวม Git กับฐานข้อมูลที่มิเรอร์ดูที่ CI/CD สําหรับฐานข้อมูลมิเรอร์เรอร์

ไฟล์สมุดบันทึก

โฟลเดอร์สมุดบันทึกประกอบด้วย ไฟล์.py :

สําหรับคําแนะนําเกี่ยวกับการใช้การรวม Git กับสมุดบันทึก ให้ดู ตัวควบคุมแหล่งข้อมูลของสมุดบันทึกและการปรับใช้

ไฟล์รายงานที่มีการแบ่งหน้า

โฟลเดอร์รายงานที่มีการแบ่งหน้าประกอบด้วย ไฟล์ .rdl ที่กําหนดรายงานที่มีการแบ่งหน้า RDL (Report Definition Language) เป็นการแสดง XML ของข้อกําหนดของรายงานที่มีการแบ่งหน้า

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับ RDL ดู Report Definition Language (RDL) สําหรับคําแนะนําเกี่ยวกับการใช้การรวม Git กับรายงานที่มีการแบ่งหน้า โปรดดู การรวม Git กับรายงานที่มีการแบ่งหน้า

ไฟล์รายงาน

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

  • definition.pbir
  • report.json

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับโฟลเดอร์รายงานและรายการเนื้อหาทั้งหมด ดู ที่ โฟลเดอร์รายงานโครงการ Power BI Desktop

ไฟล์แบบจําลองแสดงความหมาย

โฟลเดอร์แบบจําลองเชิงความหมายประกอบด้วยไฟล์ต่อไปนี้:

  • definition.pbidataset
  • ไฟล์ model.bim (รูปแบบ TMSL) หรือโฟลเดอร์ \definition (รูปแบบ TMDL)

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับโฟลเดอร์แบบจําลองเชิงความหมายและรายการทั้งหมดของเนื้อหา ดู ที่โฟลเดอร์แบบจําลองความหมายของโครงการ Power BI Desktop

ไฟล์ระบบที่สร้างขึ้นโดยอัตโนมัติ

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

  • ไดเรกทอรีเวอร์ชัน 1 ประกอบด้วย item.metadata.json และ item.config.json ด้วย V1 ทั้งสองไฟล์ต้องอยู่ในไดเรกทอรี
  • ไดเรกทอรีเวอร์ชัน 2 ประกอบด้วย .platform ไฟล์นี้รวมเนื้อหาของไฟล์ทั้ง item.metadata.json และ item.config.json ถ้าคุณมีไฟล์นี้ คุณไม่สามารถมีไฟล์อีกสองไฟล์ได้ ถ้าคุณกําลังใช้เวอร์ชัน 1 และคุณได้ยอมรับการเปลี่ยนแปลง ไฟล์ระบบของคุณจะได้รับการอัปเดตเป็นเวอร์ชันนี้โดยอัตโนมัติ

หมายเหตุ

ไดเรกทอรีของitem.metadata.jsonคุณต้องประกอบด้วยไฟล์ และ item.config.json หรือ.platformไฟล์ คุณไม่สามารถมีไฟล์ทั้งสามไฟล์

ไฟล์แพลตฟอร์ม

ในเวอร์ชัน 2 แทนที่จะมีไฟล์ต้นฉบับสองไฟล์ในแต่ละไดเรกทอรีรายการ ไฟล์ .platform จะรวมข้อมูลทั้งหมดลงในไฟล์เดียวพร้อมกับคุณสมบัติ$schema ถ้าคุณมีไฟล์นี้ คุณไม่สามารถมีไฟล์อีกสองไฟล์ได้

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

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

  • version: หมายเลขรุ่นของแฟ้มระบบ หมายเลขนี้ใช้เพื่อเปิดใช้งานความเข้ากันได้ย้อนหลัง หมายเลขเวอร์ชันของสินค้าอาจแตกต่างกัน
  • logicalId: ตัวระบุพื้นที่ทํางานข้ามที่สร้างขึ้นโดยอัตโนมัติที่แสดงถึงรายการและการแสดงตัวควบคุมแหล่งข้อมูล
  • type: (สตริง) ชนิดของหน่วยข้อมูล (แบบจําลองความหมาย รายงาน ฯลฯ)
  • displayName: (สตริง) ชื่อของรายการ
  • description: (สตริงที่เลือกได้) คําอธิบายของรายการ

หมายเหตุ

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

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

เริ่มต้นใช้งานการรวม Git