แชร์ผ่าน

โฟลเดอร์แบบจําลองเชิงความหมายของโครงการ Power BI Desktop

  • บทความ

สำคัญ

ขณะนี้โครงการ Power BI Desktop อยู่ในตัวอย่าง

บทความนี้อธิบายถึงไฟล์และโฟลเดอร์ย่อยในโฟลเดอร์แบบจําลองความหมายของโครงการ Microsoft Power BI Desktop ไฟล์และโฟลเดอร์ย่อยในส่วนนี้แสดงแบบจําลองความหมายของ Power BI โฟลเดอร์แบบจําลองความหมายอาจประกอบด้วย:

1 - ไฟล์นี้จําเป็น
2 - ไฟล์นี้จําเป็นเมื่อบันทึกโดยใช้รูปแบบ TMSL
3 - ไฟล์นี้จําเป็นเมื่อบันทึกโดยใช้รูปแบบ TMDL

ไม่ใช่ทุกโฟลเดอร์แบบจําลองเชิงความหมายของโครงการที่มีไฟล์และโฟลเดอร์ย่อยทั้งหมดที่อธิบายไว้ที่นี่

ไฟล์แบบจําลองเชิงความหมาย

.pbi\localSettings.json

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

สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารเค้าร่าง localSettings.json

.pbi\editorSettings.json

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

สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารเค้าร่าง editorSettings.json

.pbi\cache.abf

ไฟล์ Analysis Services Backup (ABF) ที่มีสําเนาแคชภายในเครื่องของแบบจําลองและข้อมูลเมื่อแก้ไขครั้งล่าสุด ซึ่งควรรวมอยู่ใน gitIgnore หรือการยกเว้นตัวควบคุมแหล่งข้อมูลอื่นๆ ตามค่าเริ่มต้น Git จะละเว้นไฟล์นี้

Power BI Desktop สามารถเปิดโครงการโดยไม่มีไฟล์ cache.abf ได้ ในกรณีดังกล่าว จะเป็นการเปิดรายงานที่เชื่อมต่อกับแบบจําลองที่มีข้อกําหนดทั้งหมด แต่ไม่มีข้อมูล ถ้ามี cache.abf อยู่ Power BI Desktop จะโหลดข้อมูลและเขียนทับข้อกําหนดแบบจําลองด้วยเนื้อหาใน model.bim

.pbi\unappliedChanges.json

Power BI Desktop ช่วยให้คุณสามารถบันทึกการเปลี่ยนแปลงที่ทําในตัวแก้ไขการแปลงข้อมูล (Power Query) โดยไม่ต้องใช้การเปลี่ยนแปลงเหล่านั้นกับแบบจําลองข้อมูลก่อน

รูปภาพแสดงกล่องโต้ตอบนําการเปลี่ยนแปลงคิวรีไปใช้

เมื่อคุณเลือก นําไปใช้ในภายหลัง การเปลี่ยนแปลงที่ไม่ได้ใช้จะถูกบันทึกลงในไฟล์ unappliedChanges.json เมื่อการเปลี่ยนแปลงที่ค้างอยู่อยู่ในไฟล์ unappliedChanges, Power BI Desktop จะพร้อมท์ให้คุณนําไปใช้ หรือละทิ้งการเปลี่ยนแปลงเหล่านั้นที่ค้างอยู่:

รูปภาพแสดงคําเตือนการเปลี่ยนแปลงที่ค้างอยู่

ถ้าคุณเลือก ใช้การเปลี่ยนแปลง Power BI Desktop จะเขียนทับคิวรีใน model.bim ด้วยคิวรีจาก unappliedChanges.json ถ้าคุณแก้ไขคิวรีใน model.bim ภายนอก Power BI Desktop และมีไฟล์ unappliedChanges.json ก่อนหน้า การเปลี่ยนแปลงของคุณจะสูญหายและแทนที่ด้วยคิวรีใน unappliedChanges.json เมื่อมีการใช้การเปลี่ยนแปลงเหล่านั้น

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

สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารเค้าร่าง unappliedChanges.json

definition.pbism

ประกอบด้วยข้อกําหนดโดยรวมของแบบจําลองความหมายและการตั้งค่าหลัก

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

เวอร์ชัน รูปแบบที่ได้รับการสนับสนุน
1.0 ต้องจัดเก็บคํานิยามแบบจําลองความหมายเป็น TMSL ในไฟล์ model.bim
4.0 หรือสูงกว่า ข้อกําหนดแบบจําลองเชิงความหมายสามารถจัดเก็บเป็น TMSL (ไฟล์ model.bim) หรือ TMDL (\definition โฟลเดอร์) ได้

สําหรับข้อมูลเพิ่มเติม ให้ดู เอกสารเค้าร่าง definition.pbism

model.bim

ไฟล์นี้จะพร้อมใช้งานเมื่อมีการบันทึกโครงการ Power BI โดยใช้รูปแบบ TMSL ซึ่งประกอบด้วยข้อกําหนดออบเจ็กต์ฐานข้อมูล Tabular Model Scripting Language (TMSL) ของแบบจําลองโครงการ

definition\ folder

โฟลเดอร์นี้จะพร้อมใช้งานเมื่อมีการบันทึกโครงการ Power BI โดยใช้ รูปแบบ TMDL ซึ่งจะแทนที่ไฟล์ model.bim

โฟลเดอร์นี้ประกอบด้วยข้อกําหนดวัตถุฐานข้อมูล Tabular Model Definition Language (TMDL) ของแบบจําลองโครงการ

diagramLayout.json

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

แท่น

ไฟล์แพลตฟอร์มผ้าที่มีคุณสมบัติสําคัญสําหรับการสร้างและรักษาการเชื่อมต่อระหว่างรายการ Fabric และ Git

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

รูปแบบ TMDL

ด้วยวัตถุประสงค์ของการมอบการควบคุมแหล่งข้อมูลที่ดีกว่าและประสบการณ์การพัฒนาร่วมคุณสามารถบันทึกไฟล์โครงการ Power BI (PBIP) ของคุณโดยใช้ Tabular Model Definition Language (TMDL) เป็นรูปแบบไฟล์แบบจําลองความหมาย

ซึ่งแตกต่างจาก Tabular Model Scripting Language (TMSL) TMDL ได้รับการออกแบบมาตั้งแต่เริ่มต้นให้เป็นมิตรกับมนุษย์ ซึ่งไม่เพียงแต่สามารถอ่านได้เท่านั้น แต่ยังง่ายต่อการแก้ไขในตัวแก้ไขข้อความต่าง ๆ ซึ่งแสดงถึงการปรับปรุงที่สําคัญสําหรับประสบการณ์การควบคุมแหล่งข้อมูลและการพัฒนาการทํางานร่วมกัน

สกรีนช็อตของ diffs TMDL ที่เป็นมิตร

แทนที่จะเป็นไฟล์ JSON ขนาดใหญ่ เช่น Tabular Model Scripting Language (TMSL) TMDL มีโครงสร้างโฟลเดอร์ที่มีไฟล์แยกต่างหากสําหรับแต่ละตาราง มุมมอง บทบาท และวัฒนธรรม ซึ่งทําให้ง่ายต่อการทํางานกับผู้อื่น และเพื่อทําความเข้าใจโครงสร้างแบบจําลองเชิงความหมาย โดยเพียงแค่ดูที่โฟลเดอร์และไฟล์ ในท้ายที่สุดสิ่งนี้นําไปสู่การควบคุมแหล่งข้อมูลที่ยอดเยี่ยมและประสบการณ์การพัฒนาร่วมเมื่อจัดการกับความขัดแย้งของ git diff และผสาน

สกรีนช็อตของความแตกต่าง TMDL ของแบบจําลองความหมาย

เรียนรู้เพิ่มเติมเกี่ยวกับ TMDL ได้ที่นี่

เปิดใช้งานคุณลักษณะตัวอย่างรูปแบบ TMDL

การบันทึกเป็นโครงการ Power BI โดยใช้ TMDL กําลังอยู่ในช่วงการแสดงตัวอย่าง ก่อนใช้งาน คุณต้องเปิดใช้งานใน คุณลักษณะตัวอย่าง ก่อน:

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

บันทึกเป็นโครงการโดยใช้ TMDL

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

สกรีนช็อตของโฟลเดอร์ข้อกําหนดภายในโฟลเดอร์แบบจําลองความหมาย

เรียนรู้เพิ่มเติมเกี่ยวกับ โครงสร้างโฟลเดอร์ TMDL

แปลง PBIP ที่มีอยู่เป็น TMDL

ถ้าคุณมี PBIP ที่ใช้ TMSL เป็นรูปแบบแบบจําลองความหมายแล้ว คุณสามารถแปลงเป็น TMDL ดังนี้:

  1. เปิด PBIP ใน Power BI Desktop

  2. ตรวจสอบให้แน่ใจว่าได้เปิดใช้งานคุณลักษณะการแสดงตัวอย่าง

  3. บันทึก โครงการ พร้อมท์จะปรากฏขึ้นเพื่อขอให้คุณอัปเกรดเป็น TMDL

  4. เลือก อัปเกรด

    สำคัญ

    เมื่อคุณอัปเกรดเป็น TMDL คุณจะไม่สามารถแปลงกลับเป็น TMSL ได้ ถ้าคุณคิดว่าคุณอาจต้องการย้อนกลับไปยัง TMSL ให้บันทึกสําเนาของไฟล์ PBIP ของคุณก่อน

    สกรีนช็อตของพร้อมท์ที่จะอัปเกรดโฟลเดอร์แบบจําลองความหมายเป็น TMDL

ไฟล์ Tabular Model Scripting Language (TMSL) ที่มีอยู่ (model.bim) จะถูกแทนที่ด้วย โฟลเดอร์ \definition ที่ประกอบด้วยการเป็นตัวแทน TMDL ของแบบจําลองความหมาย

ภาพหน้าจอของโครงการ PBIP ที่มีโฟลเดอร์ TMSL และโฟลเดอร์ TMDL

ถ้าคุณเลือกที่จะ เก็บรูปแบบปัจจุบัน เดสก์ท็อปจะไม่พร้อมท์อีกครั้งเพื่ออัปเกรด

ทําการเปลี่ยนแปลงภายนอกไปยังไฟล์ TMDL

เพื่อให้อ่านและแก้ไขไฟล์ TMDL ของคุณได้ดียิ่งขึ้น ให้ ติดตั้งส่วนขยาย TMDL - Visual Studio Marketplace Microsoft VS Code

เปิดโฟลเดอร์ PBIP โดยใช้ VS Code และนําทางไปยังโฟลเดอร์ข้อกําหนดแบบจําลองเชิงความหมาย

สกรีนช็อตของโฟลเดอร์ข้อกําหนดแบบจําลองความหมายใน VS Code

Power BI Desktop ไม่ทราบการเปลี่ยนแปลงของไฟล์โครงการที่ทําโดยเครื่องมืออื่น ๆ ดังนั้น ถ้าคุณทําการเปลี่ยนแปลงใด ๆ ในการเปิดไฟล์ภายนอก Power BI Desktop คุณจําเป็นต้องรีสตาร์ทเพื่อให้การเปลี่ยนแปลงเหล่านั้นแสดงใน Power BI Desktop

โปรดดูที่นี่สําหรับการดําเนินการเขียนที่รองรับภายนอก Power BI Desktop

ข้อผิดพลาด TMDL

หากการแก้ไขที่ไม่ถูกต้องเกิดขึ้นกับไฟล์ TMDL Power BI Desktop จะแสดงข้อผิดพลาดเมื่อเปิดโดยระบุตําแหน่งของข้อผิดพลาด:

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

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

ในระหว่างการแสดงตัวอย่าง สาธารณะ Fabric Git Integration จะยังคงส่งออกแบบจําลองความหมายโดยใช้ TMSL ตามค่าเริ่มต้น อย่างไรก็ตาม ถ้ามีการนําเข้าแบบจําลองความหมายลงใน Fabric โดยใช้ Fabric Git Integration ที่มีรูปแบบ TMDL ดังนั้น Fabric Git Integration จะใช้รูปแบบ TMDL เพื่อส่งออกข้อกําหนดแบบจําลองความหมายไปยัง Git ถ้ามีการเปลี่ยนแปลงแบบจําลองความหมายใด ๆ ในบริการ

สำคัญ

ถ้าคุณนําเข้าแบบจําลองความหมายของคุณโดยใช้วิธีการนําเข้าอื่น ๆ เช่น Power BI Desktop Publish, Fabric Git Integration จะเปลี่ยนกลับไปเป็นรูปแบบ TMSL เริ่มต้น

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