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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ฐานข้อมูลมิเรอร์
• Notebook
• รายงานที่มีหน้าข้อมูล
• Report
• แบบจําลองความหมาย

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

โฟลเดอร์ฐานข้อมูลที่มิเรอร์ประกอบด้วยแฟ้ม .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.pbism
• \definition โฟลเดอร์ที่มีไฟล์ TMDL

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

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

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

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

Note

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

เวอร์ชัน 2

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

ในเวอร์ชัน 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: (สตริงที่เลือกได้) คําอธิบายของรายการ

ถ้าคุณเปลี่ยนชื่ออาร์ติแฟกต์ในพื้นที่ทํางานและโฟลเดอร์อาร์ติแฟกต์ใน Git มีคําต่อท้าย '.' ดังนั้นหลังจากใส่ displayName ชื่อไดเรกทอรี และ ใน Git จะตรงกัน

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

Note

เมื่อคุณบันทึกการเปลี่ยนแปลงไปยัง Git ในเวอร์ชัน 1 ไฟล์ระบบจะได้รับการอัปเดตโดยอัตโนมัติเป็นเวอร์ชัน 2 พร้อมกับการเปลี่ยนแปลง นอกจากนี้ ไฟล์ใหม่ใด ๆ ที่ส่งออกจากโหมดนักพัฒนา Power BI Desktop จะถูกบันทึกในรูปแบบไฟล์เวอร์ชัน 2

เวอร์ชัน 1

ถ้าคุณกําลังใช้เวอร์ชัน 1 แต่ละไดเรกทอรีรายการมีสองไฟล์:

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

ไฟล์ข้อมูลเมตา

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

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

• type: (สตริง) ชนิดของหน่วยข้อมูล (แบบจําลองความหมาย รายงาน ฯลฯ)
• displayName: (สตริง) ชื่อของรายการ
• description: (สตริงทางเลือก) คําอธิบายของรายการ

เมื่อต้องการเปลี่ยนชื่อรายการ ให้เปลี่ยน ใน displayName ไฟล์ 'item.metadata.json' การเปลี่ยนชื่อของโฟลเดอร์จะไม่เปลี่ยนชื่อที่แสดงของรายการในพื้นที่ทํางาน

ไฟล์กําหนดค่า

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

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

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

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

Note

เมื่อคุณบันทึกการเปลี่ยนแปลงไปยัง Git ในเวอร์ชัน 1 ไฟล์ระบบจะได้รับการอัปเดตโดยอัตโนมัติเป็นเวอร์ชัน 2 พร้อมกับการเปลี่ยนแปลง นอกจากนี้ ไฟล์ใหม่ใด ๆ ที่ส่งออกจากโหมดนักพัฒนา Power BI Desktop จะถูกบันทึกในรูปแบบไฟล์เวอร์ชัน 2

Note

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

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

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