โครงการ Power BI Desktop

Tip

สําหรับคําแนะนําเกี่ยวกับวิธีการวางแผนการพัฒนา Power BI โปรดดู การวางแผนการใช้งาน Power BI

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

การบันทึกงานของคุณเป็นโครงการมีประโยชน์ดังต่อไปนี้:

  • สนับสนุนตัวแก้ไขข้อความ - ไฟล์ PBIP เป็นไฟล์ข้อความที่มีรูปแบบความหมายและเมตาดาต้าของรายงาน ไฟล์เหล่านี้ได้รับการจัดทําเป็นเอกสารสาธารณะและสามารถอ่านได้ ในขณะที่ไฟล์โครงการสนับสนุนเครื่องมือแก้ไขข้อความอย่างง่ายเช่น Notepad คุณควรใช้ตัวแก้ไขโค้ดเช่น Visual Studio Code (VS Code) ซึ่งมอบประสบการณ์การแก้ไขที่หลากหลายรวมถึงการรวม intellisense การตรวจสอบความถูกต้อง และ Git

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

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

  • การสนับสนุน Continuous Integration และ Continuous Delivery (CI/CD) - ใช้แนวทางปฏิบัติ CI/CD กับระบบควบคุมแหล่งข้อมูลที่มีอยู่ของคุณโดยใช้ไฟล์ PBIP ซึ่งประกอบด้วย ประตูคุณภาพ และการปรับใช้กับสภาพแวดล้อมการผลิตโดยอัตโนมัติ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ CI/CD ใน Fabric โปรดดู เวิร์กโฟลว์ Fabric CI/CD

  • การสร้างโปรแกรมและแก้ไขข้อกําหนดหน่วยข้อมูล - คุณสามารถสร้างและปรับเปลี่ยนไฟล์ข้อความข้อกําหนดหน่วยข้อมูลได้โดยทางโปรแกรม เปิดใช้งานการทํางานแบบชุดงาน เช่น การอัปเดตวิชวลของหน้ารายงานทั้งหมดหรือการเพิ่มชุดหน่วยวัดในแต่ละตาราง สําหรับแบบจําลองเชิงความหมาย คุณสามารถใช้ Tabular Object Model (TOM) ไลบรารีไคลเอ็นต์เพื่อยกเลิกการกําหนดความสัมพันธ์เมตาดาต้าของแบบจําลองเชิงความหมาย ทําการแก้ไขโปรแกรม และทําให้เป็นอนุกรมกลับไปยังไฟล์

บันทึกเป็นโครงการ

ถ้าคุณกําลังทํางานในโครงการใหม่ หรือคุณได้เปิดไฟล์ Power BI Desktop (pbix) ที่มีอยู่ คุณสามารถบันทึกงานของคุณเป็นไฟล์โครงการ Power BI (pbip):

จับภาพหน้าจอที่แสดงบันทึกไฟล์เป็นโครงการ Power BI

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

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

ลองมาดูรายละเอียดสิ่งที่คุณเห็นในโฟลเดอร์รากของโครงการของคุณ:

<ชื่อ>โครงการ SemanticModel

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

<ชื่อ>โครงการ รายงาน

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

.gitIgnore

ระบุ Git ของไฟล์ที่ไม่ได้ติดตามโดยตั้งใจควรละเว้นสําหรับไฟล์โครงการ Power BI เช่น cache.abf และ localSettings.json

Power BI Desktop จะสร้างไฟล์ .gitignore เฉพาะในกรณีที่ไม่มีอยู่ในโฟลเดอร์บันทึกที่เลือกหรือที่เก็บ Git หลัก

เนื้อหาเริ่มต้นของ gitignore เมื่อบันทึกเป็น PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<project name.pbip>

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

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

เปิดโครงการ Power BI

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

คุณสามารถบันทึกรายงานและแบบจําลองความหมายหลายรายการไปยังโฟลเดอร์เดียวกันได้ ไม่จําเป็นต้องมีไฟล์ pbip แยกต่างหากสําหรับแต่ละรายงาน เนื่องจากคุณสามารถเปิดแต่ละรายงานได้โดยตรงจาก .pbir ภายในโฟลเดอร์รายงาน

project/
├── AdventureWorks-Sales.Report/
│   └── definition.pbir
├── AdventureWorks-Stocks.Report/
│   └── definition.pbir
├── AdventureWorks.SemanticModel/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

หลังจากบันทึกเป็นโครงการ คุณสามารถดูเมื่อคุณกําลังทํางานบนโครงการโดยดูที่แถบชื่อเรื่อง:

จับหน้าจอแสดงชื่อ Power BI Desktop เมื่อบันทึกไปยังโครงการ

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

จับหน้าจอแสดงเมนูลอยชื่อ Power BI Desktop

การเปลี่ยนแปลงภายนอก Power BI Desktop

เมื่อบันทึกเป็นโครงการ คุณไม่ได้ถูกบังคับให้ทําการเปลี่ยนแปลงไปยังแบบจําลองความหมายและข้อกําหนดของรายงานเฉพาะใน Power BI Desktop เท่านั้น คุณสามารถใช้เครื่องมืออื่น ๆ เช่น VS Code เครื่องมือชุมชนแบบโอเพนซอร์ส เช่น ตัวแก้ไขตาราง หรือแม้แต่ Notepad ได้ อย่างไรก็ตาม ไม่ใช่ทุกไฟล์หรือการเปลี่ยนแปลงจะรองรับการแก้ไขโดยเครื่องมือโอเพนซอร์สภายนอก

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

ถ้าเป็นไปได้ Power BI Desktop จะระบุไฟล์และตําแหน่งที่ตั้งของข้อผิดพลาด:

การจับหน้าจอของข้อผิดพลาดไม่สามารถเปิดไฟล์ได้

ไม่มีการบันทึกรายละเอียด Schema สําหรับไฟล์ต่อไปนี้ การเปลี่ยนแปลงไปยังไฟล์เหล่านี้ภายนอก Power BI Desktop ไม่ได้รับการสนับสนุน:

ปรับใช้กับพื้นที่ทํางาน Fabric

เมื่อทํางานกับไฟล์โครงการ Power BI คุณสามารถปรับใช้เนื้อหาของคุณไปยังพื้นที่ทํางาน Fabric โดยใช้กลไกการเผยแพร่ต่อไปนี้:

  • ใช้การรวม Fabric Git
  • ใช้ Fabric API
  • ใช้ตัวเลือก เผยแพร่ Power BI Desktop

Note

การเผยแพร่ผ่าน Power BI Desktop เผยแพร่ ใช้ไฟล์ PBIX ชั่วคราวที่เผยแพร่ไปยังบริการ คล้ายกับการบันทึกและเผยแพร่ไฟล์ PBIX วิธีการเผยแพร่นี้จะปรับใช้ทั้งเมตาดาต้าและแคชข้อมูลภายในเครื่องของ แก้ไขแบบจําลองความหมายซึ่งไม่เหมือนกับตัวเลือกการปรับใช้ PBIP อื่น ๆ

การเขียนแบบจําลอง

คุณสามารถทําการเปลี่ยนแปลงข้อกําหนดของแบบจําลองความหมายได้โดยใช้เครื่องมือภายนอกในสองวิธี:

  • โดยการเชื่อมต่อกับอินสแตนซ์ Analysis Service (AS) ของ Power BI Desktop ด้วยเครื่องมือภายนอก
  • โดยการแก้ไขเมตาดาต้า TMDL ใน /definition โฟลเดอร์โดยใช้ VS Code หรือเครื่องมือภายนอกอื่น

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

โปรดจําไว้ว่า:

  • เมื่อคุณบันทึกการเปลี่ยนแปลงไปยังแฟ้มโครงการภายนอก Power BI Desktop Power BI Desktop จะตรวจหาการเปลี่ยนแปลงและพร้อมท์ให้คุณนําไปใช้ด้วยการคลิกครั้งเดียว คุณยังสามารถเปิดโครงการได้โดยตรงใน Visual Studio Code โดยใช้จุดเข้าใช้งานที่มีอยู่ภายใน Power BI Desktop สําหรับเวิร์กโฟลว์ที่เสร็จสมบูรณ์ ดู แก้ไขไฟล์ PBIP ภายนอก Power BI Desktop

  • ตารางวันที่อัตโนมัติที่สร้างขึ้นโดย Power BI Desktop ไม่ควรเปลี่ยนแปลงโดยใช้เครื่องมือภายนอก

  • ถ้าแบบจําลองความหมายมีการเปิดใช้งานคุณลักษณะวันที่ /เวลาอัตโนมัติ และคุณสร้างคอลัมน์วันที่และเวลาใหม่ภายนอก Power BI Desktop ตารางวันที่ภายในเครื่องจะไม่ถูกสร้างขึ้นโดยอัตโนมัติ

  • โมเดลความหมาย เช่น โมเดลคอมโพสิต หรือ Direct Lake สามารถรวมออบเจ็กต์และคุณสมบัติที่มาจากโมเดลหรือแหล่งข้อมูลอื่นๆ เมื่อกําหนดคุณสมบัติเหล่านี้หรือลบวัตถุที่ซิงค์ออก Power BI จําเป็นต้องมี changedProperties คุณสมบัติและ PBI_RemovedChildren คําอธิบายประกอบที่จะตั้งค่า ตัวบ่งชี้เหล่านี้ทําเครื่องหมายการเปลี่ยนแปลงเป็นการกําหนดเองของผู้ใช้ ตรวจสอบให้แน่ใจว่าจะถูกเก็บรักษาไว้ในระหว่างการซิงโครไนซ์ Schema ถัดไปกับแหล่งข้อมูล เมื่อต้องการเรียนรู้เพิ่มเติม ดูแท็กสายข้อมูลสําหรับแบบจําลองความหมาย Power BI

  • การแก้ไขนิพจน์ใดๆ ภายนอก Power BI Desktop ในโครงการที่มี unappliedChanges.json จะสูญหายเมื่อมีการใช้การเปลี่ยนแปลงเหล่านั้น

สคีมาของไฟล์ JSON

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

ด้วยสคีมา JSON คุณสามารถ:

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

ใช้ VS Code เพื่อแมป Schema JSON ไปยังไฟล์ที่กําลังสร้าง สคีมา JSON สําหรับไฟล์โครงการมีอยู่ในที่เก็บ Json-schemas Git

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

  • Power BI Desktop ตรวจหาการเปลี่ยนแปลงที่คุณทําโดยใช้เครื่องมือหรือแอปพลิเคชันอื่นๆ และพร้อมท์ให้คุณนําไปใช้ จุดเข้าใช้งานในตัวใน Power BI Desktop เปิดโครงการโดยตรงใน Visual Studio Code
  • ไม่รองรับป้ายชื่อระดับความลับกับโครงการ Power BI
  • มุมมองไดอะแกรมจะถูกละเว้นเมื่อแก้ไขแบบจําลองในบริการ
  • เมื่อบันทึก PBIP โปรดทราบว่าความยาวเส้นทางสูงสุดสําหรับไฟล์โครงการถูกจํากัดไว้ที่ 260 อักขระตามค่าเริ่มต้นบน Windows เนื่องจากไฟล์ PBIP ถูกเก็บไว้เป็นโฟลเดอร์ย่อยและไฟล์ ชื่ออ็อบเจ็กต์แบบยาว เช่น ชื่อตาราง อาจทําให้ความยาวเส้นทางทั้งหมดเกินขีดจํากัดนี้ ซึ่งส่งผลให้เกิดข้อผิดพลาดระหว่างการดําเนินการบันทึก เพื่อลดความเสี่ยงนี้ ให้ใช้เส้นทางโฟลเดอร์แบบสั้นเป็นตําแหน่งรากสําหรับ PBIP ของคุณ
  • ใน Power BI Desktop คุณไม่สามารถบันทึกเป็น PBIP โดยตรงไปยัง OneDrive และ SharePoint ได้ คุณสามารถใช้ บันทึกเป็น เพื่อบันทึกไฟล์ไปยังโฟลเดอร์ OneDrive ที่ซิงค์ในเครื่อง อย่างไรก็ตาม สิ่งนี้อาจทําให้เกิดปัญหาการซิงค์ไฟล์ ซึ่งอาจนําไปสู่การดําเนินการบันทึกที่ล้มเหลวใน Power BI Desktop
  • เมื่อแก้ไขไฟล์ PBIP ภายนอก Power BI Desktop ควรบันทึกโดยใช้ UTF-8 โดยไม่มีการเข้ารหัส BOM
  • ไม่รองรับรูปแบบภาษา (คําพ้องหน้ารายงาน) กับโครงการ Power BI
  • Power BI Desktop ใช้ CRLF เป็นจุดสิ้นสุดของบรรทัด เพื่อหลีกเลี่ยงปัญหาใน diffs ของคุณ ให้กําหนดค่า Git เพื่อจัดการกับการลงท้ายบรรทัดโดยเปิดใช้งาน autocrlf
  • ในขณะนี้ ยังไม่รองรับโครงการ Power BI ในเวอร์ชัน Microsoft Power BI Desktop ที่ปรับให้เหมาะสมสําหรับเซิร์ฟเวอร์รายงาน Power BI
  • ไม่สามารถรับและตั้งค่าสมาชิกบทบาทความปลอดภัยระดับแถวโดยใช้ Fabric REST API
  • ไม่สามารถรับและตั้งค่าพาร์ติชันการรีเฟรชแบบเพิ่มหน่วยโดยใช้ Fabric REST API อย่างไรก็ตาม จะส่งออกพาร์ติชันเดียวโดยใช้แบบสอบถามที่กําหนดไว้ในนโยบายการรีเฟรช

คำถามที่ถามบ่อย

ปัญหา: เมื่อดูแบบจําลองความหมายและคําจํากัดความของโฟลเดอร์รายการรายงานมีเพียงไม่กี่ไฟล์เท่านั้นที่ถูกทําเครื่องหมายว่าจําเป็นจะเกิดอะไรขึ้นหากฉันลบออก

ตอบ: Power BI Desktop จะสร้างโดยอัตโนมัติเมื่อคุณบันทึกเป็นโครงการ (PBIP)

ปัญหา: Power BI Desktop รับทราบถึงการเปลี่ยนแปลงที่ฉันทํากับไฟล์โครงการ Power BI จากเครื่องมือหรือแอปพลิเคชันภายนอกหรือไม่

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

ปัญหา: ถ้าฉันแปลง PBIX เป็น PBIP ฉันสามารถแปลงกลับเป็น PBIX ได้หรือไม่

ตอบ: ใช่ คุณสามารถบันทึก PBIX เป็น PBIP หรือบันทึก PBIP เป็น PBIX ได้

ปัญหา: ฉันสามารถแปลง PBIX เป็น PBIP และในทางกลับกันโดยทางโปรแกรมได้หรือไม่

ตอบ: ไม่ใช่ คุณสามารถแปลง PBIX เป็น PBIP และในทางกลับกันได้โดยใช้ บันทึกเป็น ไฟล์>ของ Power BI Desktop เท่านั้น

ปัญหา: ฉันสามารถปรับใช้โครงการ Power BI Desktop กับ Azure Analysis Services (AAS) หรือ SQL Server Analysis Services (SSAS) ได้หรือไม่

ตอบ: ไม่ใช่ ข้อกําหนดรายงานของโครงการ Power BI Desktop ไม่ได้รับการสนับสนุนใน AAS และ SSAS และข้อกําหนดแบบจําลองใช้เมตาดาต้าที่ปรับปรุงประสิทธิภาพแล้วซึ่งไม่ซ้ํากันกับ Power BI สําหรับโครงการ AAS และ SSAS ให้ใช้ Microsoft Visual Studio สําหรับการสร้างแบบจําลอง การรวม Git และ Azure DevOps

ปัญหา: เหตุใดจึงไม่มีไฟล์ *.pbip เมื่อฉันเชื่อมต่อพื้นที่ทํางาน Fabric กับ Git ฉันสามารถแก้ไขรายงานและแบบจําลองความหมายของฉันใน Power BI Desktop ได้อย่างไร

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

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

  • อัปเดตล่าสุดเมื่อ