การติดตั้ง Power Query SDK

  • บทความ
  • 2 นาทีในการอ่าน

Quickstart

หมายเหตุ

ขั้นตอนในการเปิดใช้งานส่วนขยายที่มีการเปลี่ยนแปลงในเวอร์ชันเดือนมิถุนายน 2017 Power BI Desktopเวอร์ชัน

  1. ติดตั้งPower Query SDKจาก Visual Studio Marketplace
  2. สร้างโครงการตัวเชื่อมต่อข้อมูลใหม่
  3. กําหนดตรรกะของตัวเชื่อมต่อของคุณ
  4. สร้างโครงการเพื่อสร้างไฟล์นามสกุล
  5. คัดลอกไฟล์ส่วนขยายลงใน [Documents]/Power BI Desktop/Custom Connectors
  6. เลือกตัวเลือก (ไม่ แนะ|) อนุญาตให้โหลดส่วนขยายใด ๆ โดยไม่มีการตรวจสอบความถูกต้องหรือPower BI Desktop (ภายใต้ ไฟล์| ตัวเลือกและการตั้งค่า| ตัวเลือก| | ส่วนขยายข้อมูล)
  7. รีสตาร์ต Power BI Desktop

คุณลักษณะตัวอย่าง

การกระจายของตัวเชื่อมต่อข้อมูล

Power BI Desktopสามารถดาวน์โหลดไฟล์ส่วนขยาย และวางไฟล์เหล่านั้นในไดเรกทอรีที่รู้จัก (ขั้นตอนที่อธิบายไว้ด้านบน) Power BI Desktopโหลดส่วนขยายโดยอัตโนมัติในการรีสตาร์ท

ทีละขั้นตอน

การสร้างส่วนขยายใหม่ใน Visual Studio

การติดตั้ง SDK Power Query ทั่วไปVisual Studioจะสร้างเทมเพลตโครงการตัวเชื่อมต่อข้อมูลใหม่Visual Studioเชื่อมต่อ

ซึ่งสร้างโครงการใหม่ที่ประกอบด้วยไฟล์ต่อไปนี้:

  • ไฟล์นิยามตัวเชื่อมต่อ ( <connectorName> .pq)
  • ไฟล์ทดสอบคิวรี <connectorName> (.query.pq)
  • ไฟล์ทรัพยากรสตริง (resources.resx)
  • ไฟล์ PNG ของขนาดต่าง ๆ ที่ใช้ในการสร้างไอคอน

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

การทดสอบใน Visual Studio

ฟังก์ชัน Power Query SDK ให้ความสามารถในการประมวลผลคิวรีพื้นฐาน ซึ่งช่วยให้คุณสามารถทดสอบส่วนขยายของคุณได้โดยไม่ต้องสลับไปยังPower BI Desktopบริการ ดู ไฟล์คิว รี เพื่อดูรายละเอียดเพิ่มเติม

สร้างและปรับใช้จากVisual Studio

การสร้างโครงการของคุณจะสร้างไฟล์ .pqx ของคุณ

โครงการตัวเชื่อมต่อข้อมูลไม่สนับสนุนขั้นตอนการสร้างโพสต์แบบเองเพื่อคัดลอกไฟล์ส่วนขยายไปยังไดเรกทอรี [Documents]\Microsoft Power BI Desktop\Custom Connectors ของคุณ ถ้านี่เป็นสิ่งที่คุณต้องการสร้าง คุณอาจต้องการใช้ของบริษัทอื่นเพื่อขยายVisual Studio เช่น การปรับใช้อัตโนมัติ

ไฟล์นามสกุล

Power Queryไฟล์จะถูกรวมในไฟล์ ZIP และนามสกุลไฟล์ .mez ในขณะใช้งาน Power BI Desktopโหลดส่วนขยายจาก [Documents]\Microsoft Power BI Desktop\Custom Connectors

หมายเหตุ

ในการเปลี่ยนแปลงที่จะเกิดขึ้น ส่วนขยายเริ่มต้นจะถูกเปลี่ยนจาก .mez เป็น .pqx

รูปแบบไฟล์ส่วนขยาย

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

  • โดยเริ่มต้นด้วยการประกาศส่วน (ตัวอย่างเช่น section HelloWorld; )
  • แต่ละนิพจน์ลงท้ายด้วยเครื่องหมายอัฒภาค ( a = 1; ตัวอย่างเช่น b = let c = 1 + 2 in c; หรือ )
  • ฟังก์ชันและตัวแปรทั้งหมดอยู่ในเอกสารส่วน เว้นแต่ว่าจะถูกเครื่องหมายเป็น แชร์ ฟังก์ชันที่ใช้ร่วมกันสามารถมองเห็นคิวรี/ฟังก์ชันอื่น ๆ และสามารถคิดว่าเป็นการส่งออกส่วนขยายของคุณ (นั่นคือ สามารถเรียกได้จากหลายบริการPower Query)

คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับเอกสารส่วน M ได้ที่ข้อมูลเฉพาะของภาษา M

ไฟล์คิวรี

นอกเหนือจากไฟล์ส่วนขยาย แล้ว โครงการ ตัวเชื่อมต่อข้อมูล สามารถมีไฟล์คิวรี (name.query.pq) ได้ ไฟล์นี้สามารถใช้เพื่อเรียกใช้คิวรีทดสอบภายในVisual Studioของคุณ การประเมินคิวรีจะรวมโค้ดส่วนขยายของคุณโดยอัตโนมัติโดยไม่ต้องลงทะเบียนไฟล์ .pqx ของคุณช่วยให้คุณสามารถเรียกใช้/ทดสอบฟังก์ชันที่ใช้ร่วมกันใด ๆ ในโค้ดส่วนขยายของคุณ

ไฟล์คิวรีสามารถมีนิพจน์เดียวได้ (ตัวอย่างเช่น HelloWorld.Contents() ), นิพจน์ let (เช่นPower Queryที่จะสร้าง) หรือเอกสารส่วน