หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทความนี้อธิบายถึงไฟล์และโฟลเดอร์ย่อยในโฟลเดอร์แบบจําลองความหมายของโครงการ Microsoft Power BI Desktop ไฟล์และโฟลเดอร์ย่อยในส่วนนี้แสดงแบบจําลองความหมายของ Power BI โฟลเดอร์แบบจําลองความหมายอาจประกอบด้วย:
- .pbi\
- โฟลเดอร์ DAXQueries\
- โฟลเดอร์ TMDLScripts\
- คําจํากัดความ\โฟลเดอร์ 3
- model.bim2
- diagramLayout.json
- แท่น
- definition.pbism1
1 - ไฟล์นี้จําเป็น
2 - ไฟล์นี้จําเป็นเมื่อบันทึกโดยใช้รูปแบบ TMSL
3 - ไฟล์นี้จําเป็นเมื่อบันทึกโดยใช้รูปแบบ TMDL
ไม่ใช่ทุกโฟลเดอร์แบบจําลองเชิงความหมายของโครงการที่มีไฟล์และโฟลเดอร์ย่อยทั้งหมดที่อธิบายไว้ที่นี่
ไฟล์แบบจําลองเชิงความหมาย
เปิด .pbi\localSettings.js
ประกอบด้วยการตั้งค่าแบบจําลองความหมายที่ใช้เฉพาะสําหรับผู้ใช้และคอมพิวเตอร์ปัจจุบันเท่านั้น ซึ่งควรรวมอยู่ใน gitIgnore หรือการยกเว้นตัวควบคุมแหล่งข้อมูลอื่นๆ ตามค่าเริ่มต้น Git จะละเว้นไฟล์นี้
สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารเค้าร่าง localSettings.json
เปิด .pbi\editorSettings.js
ประกอบด้วยการตั้งค่าตัวแก้ไขแบบจําลองความหมายที่บันทึกเป็นส่วนหนึ่งของข้อกําหนดแบบจําลองความหมายสําหรับใช้ข้ามผู้ใช้และสภาพแวดล้อม
สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารเค้าร่าง editorSettings.json
.pbi\cache.abf
ไฟล์ Analysis Services Backup (ABF) ที่มีสําเนาแคชภายในเครื่องของแบบจําลองและข้อมูลเมื่อแก้ไขครั้งล่าสุด ซึ่งควรรวมอยู่ใน gitIgnore หรือการยกเว้นตัวควบคุมแหล่งข้อมูลอื่นๆ ตามค่าเริ่มต้น Git จะละเว้นไฟล์นี้
Power BI Desktop สามารถเปิดโครงการโดยไม่มีไฟล์ cache.abf ได้ ในกรณีดังกล่าว จะเป็นการเปิดรายงานที่เชื่อมต่อกับแบบจําลองที่มีข้อกําหนดทั้งหมด แต่ไม่มีข้อมูล ถ้ามี cache.abf อยู่ Power BI Desktop จะโหลดข้อมูลและเขียนทับข้อกําหนดแบบจําลองด้วยเมตาดาต้าแบบจําลองเชิงความหมายในโครงการ
เปิด .pbi\unappliedChanges.js
Power BI Desktop ช่วยให้คุณสามารถบันทึกการเปลี่ยนแปลงที่ทําในตัวแก้ไขการแปลงข้อมูล (Power Query) โดยไม่ต้องใช้การเปลี่ยนแปลงเหล่านั้นกับแบบจําลองข้อมูลก่อน
เมื่อคุณเลือก นําไปใช้ในภายหลัง การเปลี่ยนแปลงที่ไม่ได้ใช้จะถูกบันทึกลงในไฟล์ unappliedChanges.json เมื่อการเปลี่ยนแปลงที่ค้างอยู่อยู่ในไฟล์ unappliedChanges, Power BI Desktop จะพร้อมท์ให้คุณนําไปใช้ หรือละทิ้งการเปลี่ยนแปลงเหล่านั้นที่ค้างอยู่:
หากคุณเลือก ใช้การเปลี่ยนแปลง Power BI Desktop จะเขียนทับคิวรีในเมตาดาต้าแบบจําลองความหมายด้วยคิวรีจาก unappliedChanges.json ถ้าคุณแก้ไขคิวรีภายนอก 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) ของแบบจําลองโครงการ
คําจํากัดความ\โฟลเดอร์
โฟลเดอร์นี้จะพร้อมใช้งานเมื่อมีการบันทึกโครงการ Power BI โดยใช้ รูปแบบ TMDL ซึ่งจะแทนที่ไฟล์ model.bim
โฟลเดอร์นี้ประกอบด้วยข้อกําหนดวัตถุฐานข้อมูล Tabular Model Definition Language (TMDL)ของแบบจําลองโครงการ
diagramLayout.json
ประกอบด้วยเมตาดาต้าไดอะแกรมที่กําหนดโครงสร้างของแบบจําลองความหมายที่เชื่อมโยงกับรายงาน คุณไม่สามารถแก้ไขไฟล์นี้จากภายนอกได้
แท่น
ไฟล์แพลตฟอร์มผ้าที่มีคุณสมบัติสําคัญสําหรับการสร้างและรักษาการเชื่อมต่อระหว่างรายการ Fabric และ Git
หากต้องการเรียนรู้เพิ่มเติม โปรดดู การรวม Git ไฟล์ระบบที่สร้างขึ้นโดยอัตโนมัติ
โฟลเดอร์ DAXQueries\
ประกอบด้วยไฟล์สําหรับแท็บคิวรี มุมมองคิวรี DAX แต่ละแท็บที่บันทึกเป็น [Tab name].dax ไฟล์ DAX
.pbi\daxQueries.jsเปิด
ประกอบด้วยการตั้งค่าตัวแก้ไข มุมมองคิวรี DAX เช่น defaultTab หรือลําดับแท็บ
โฟลเดอร์ TMDLScripts\
มีไฟล์สําหรับแท็บสคริปต์ มุมมอง TMDL แต่ละแท็บที่บันทึกเป็น [Tab name].tmdl ไฟล์ TMDL
.pbi\tmdlscripts.jsเปิด
มีการตั้งค่าตัวแก้ไข มุมมอง TMDL เช่น defaultTab หรือลําดับแท็บ
รูปแบบ TMDL
ด้วยวัตถุประสงค์ของการมอบการควบคุมแหล่งข้อมูลที่ดีกว่าและประสบการณ์การพัฒนาร่วมคุณสามารถบันทึกไฟล์โครงการ Power BI (PBIP) ของคุณโดยใช้ Tabular Model Definition Language (TMDL) เป็นรูปแบบไฟล์แบบจําลองความหมาย
ซึ่งแตกต่างจาก Tabular Model Scripting Language (TMSL) TMDL ได้รับการออกแบบมาตั้งแต่เริ่มต้นให้เป็นมิตรกับมนุษย์ ซึ่งไม่เพียงแต่สามารถอ่านได้เท่านั้น แต่ยังง่ายต่อการแก้ไขในตัวแก้ไขข้อความต่าง ๆ ซึ่งแสดงถึงการปรับปรุงที่สําคัญสําหรับประสบการณ์การควบคุมแหล่งข้อมูลและการพัฒนาการทํางานร่วมกัน
แทนที่จะเป็นไฟล์ JSON ขนาดใหญ่ เช่น Tabular Model Scripting Language (TMSL) TMDL มีโครงสร้างโฟลเดอร์ที่มีไฟล์แยกต่างหากสําหรับแต่ละตาราง มุมมอง บทบาท และวัฒนธรรม ซึ่งทําให้ง่ายต่อการทํางานกับผู้อื่น และเพื่อทําความเข้าใจโครงสร้างแบบจําลองเชิงความหมาย โดยเพียงแค่ดูที่โฟลเดอร์และไฟล์ ในท้ายที่สุดสิ่งนี้นําไปสู่การควบคุมแหล่งข้อมูลที่ยอดเยี่ยมและประสบการณ์การพัฒนาร่วมเมื่อจัดการกับความขัดแย้งของ git diff และผสาน
เรียนรู้เพิ่มเติมเกี่ยวกับ TMDL ได้ที่นี่
ทําการเปลี่ยนแปลงภายนอกไปยังไฟล์ TMDL
คุณสามารถแก้ไขไฟล์ TMDL ใน Visual Studio Code หรือเครื่องมือภายนอกอื่น ในขณะที่โครงการยังคงเปิดอยู่ใน Power BI Desktop เพื่อให้ประสบการณ์การแก้ไข TMDL ดียิ่งขึ้น ให้ติดตั้งส่วนขยาย TMDL สําหรับ Visual Studio Code
ก่อนที่คุณจะแก้ไขไฟล์ภายนอก ให้บันทึกการเปลี่ยนแปลงใดๆ ใน Power BI Desktop เปิดโฟลเดอร์ PBIP ใน VS Code นําทางไปยังโฟลเดอร์แบบจําลอง definition ความหมายและบันทึกการเปลี่ยนแปลง TMDL ของคุณ Power BI Desktop ตรวจพบการเปลี่ยนแปลงที่บันทึกไว้ และแสดงแบนเนอร์ ใช้การเปลี่ยนแปลงภายนอก เลือก ใช้การเปลี่ยนแปลงภายนอก เพื่อโหลดแบบจําลองความหมายใหม่โดยไม่ต้องปิดและเปิดโครงการใหม่
ถ้า Power BI Desktop มีการเปลี่ยนแปลงที่ยังไม่ได้บันทึก จะแจ้งเตือนคุณว่าการใช้การเปลี่ยนแปลงภายนอกจะเขียนทับการเปลี่ยนแปลงดังกล่าว สําหรับเวิร์กโฟลว์และข้อจํากัดที่เสร็จสมบูรณ์ ดูแก้ไขไฟล์ PBIP ภายนอก Power BI Desktop
สําหรับการดําเนินการเขียนที่รองรับภายนอก Power BI Desktop ให้ดู การเขียนแบบจําลอง
ข้อผิดพลาด TMDL
ถ้าการแก้ไข TMDL ไม่ถูกต้อง Power BI Desktop จะแสดงข้อผิดพลาดเมื่อคุณใช้การเปลี่ยนแปลงภายนอกหรือเปิดโครงการ ข้อผิดพลาดระบุตําแหน่งที่ตั้งที่คุณต้องแก้ไขก่อนที่ Power BI Desktop จะสามารถโหลดแบบจําลองความหมายที่อัปเดตแล้วได้:
