ภาพรวม Power Query SDK

  • บทความ

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

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

  • สร้างมุมมองที่เป็นมิตรกับนักวิเคราะห์ธุรกิจสําหรับ REST API
  • การกําหนดตราสินค้าสําหรับแหล่งข้อมูลที่ Power Query สนับสนุนด้วยตัวเชื่อมต่อที่มีอยู่ (เช่น บริการ OData หรือโปรแกรมควบคุม ODBC)
  • ใช้โฟลว์การรับรองความถูกต้อง OAuth v2 สําหรับข้อเสนอ SaaS
  • การแสดงมุมมองที่จํากัดหรือกรองแล้วบนแหล่งข้อมูลของคุณเพื่อปรับปรุงความสามารถในการใช้งาน
  • เปิดใช้งาน DirectQuery สําหรับแหล่งข้อมูลโดยใช้โปรแกรมควบคุม ODBC

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

ขณะนี้มี Power Query SDK สองเวอร์ชันที่พร้อมใช้งาน:

  • Visual Studio Power Query SDK: เผยแพร่ในปี 2017 เป็นส่วนขยายสําหรับ Visual Studio 2017 และ 2019
  • Visual Studio Code Power Query SDK (ตัวอย่าง): เผยแพร่ในปี 2022 เป็นวิธีใหม่และแนะนําในการสร้างตัวเชื่อมต่อ Power Query

เราขอแนะนําให้นักพัฒนาทุกคนติดตั้งและใช้ Visual Studio Code Power Query SDK ที่เพิ่งเปิดตัว (ตัวอย่าง) เนื่องจากเวอร์ชันนี้จะเป็นค่าเริ่มต้นของ SDK ในอนาคต

Visual Studio Power Query SDK

ทําตามขั้นตอนด้านล่างเพื่อติดตั้ง Visual Studio Power Query SDK:

  1. ติดตั้ง Power Query SDK จาก Visual Studio Marketplace
  2. สร้างโครงการตัวเชื่อมต่อข้อมูลใหม่
  3. กําหนดตรรกะตัวเชื่อมต่อของคุณ
  4. สร้างโครงการเพื่อสร้างไฟล์นามสกุล

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

Visual Studio Code Power Query SDK (ตัวอย่าง)

หมายเหตุ

ขณะนี้ Visual Studio Code Power Query SDK ใหม่อยู่ในตัวอย่างสาธารณะ ตั้งแต่เดือนกันยายน 2022

ติดตั้ง Visual Studio Code Power Query SDK ใหม่จากส่วน Visual Studio Code ของ Visual Studio Marketplace เลือก ติดตั้ง เพื่อติดตั้ง SDK

กระบวนการพัฒนาของ เชื่อมต่อ or

แม้ว่าคุณจะสามารถใช้ Visual Studio Code หรือ Visual Studio Power Query SDK อย่างใดอย่างหนึ่ง แต่ทั้งสองอย่างนี้ใช้กระบวนการที่คล้ายกันสําหรับการพัฒนาตัวเชื่อมต่อในระดับสูง

ส่วนต่อไปนี้อธิบายในระดับสูง กระบวนการทั่วไปในการสร้างตัวเชื่อมต่อ Power Query โดยใช้ SDK

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

เมื่อสร้างโครงการใหม่ (Visual Studio Power Query SDK) หรือพื้นที่ทํางานใหม่ (Visual Studio Code Power Query SDK) คุณจะเริ่มต้นด้วยไฟล์หลักต่อไปนี้:

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

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

การทดสอบ

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

ไฟล์ทดสอบคิวรี

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

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

สร้างและปรับใช้งาน

การสร้างโครงการของคุณสร้างไฟล์ .mez หรือไฟล์นามสกุลของคุณ

ส่วนขยาย Power Query จะรวมอยู่ในไฟล์ ZIP และกําหนดนามสกุลไฟล์ .mez ในขณะทํางาน Power BI Desktop จะโหลดส่วนขยายจาก [เอกสาร]\Microsoft Power BI Desktop\Custom เชื่อมต่อ ors

หมายเหตุ

โครงการ data เชื่อมต่อ or ไม่สนับสนุนขั้นตอนการสร้างโพสต์แบบกําหนดเองเพื่อคัดลอกไฟล์ส่วนขยายไปยัง [Documents]\Microsoft Power BI Desktop\Custom เชื่อมต่อ ors directory ถ้านี่คือสิ่งที่คุณต้องการทํา คุณอาจต้องการใช้ส่วนขยายจากบุคคลที่สาม

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

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

ข้อมูลเพิ่มเติมเกี่ยวกับเอกสารส่วน M สามารถพบได้ในข้อมูลจําเพาะของภาษา M

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

สามารถใช้ตัวเชื่อมต่อ Power Query ใน Power BI Desktop หรือประสบการณ์การใช้งาน Power Query Online เช่น กระแสข้อมูล Power BI, แผนผังข้อมูล Power BI และประสบการณ์อื่น ๆ ได้

Power BI Desktop

ผู้ใช้ Power BI Desktop สามารถทําตามขั้นตอนด้านล่างเพื่อใช้ตัวเชื่อมต่อแบบกําหนดเองของ Power Query:

  1. คัดลอกไฟล์ส่วนขยาย (.mez หรือ.pqx) ลงใน [เอกสาร]/Power BI Desktop/เชื่อมต่อ ors แบบกําหนดเอง
  2. ใน Power BI Desktop เลือกตัวเลือก (ไม่แนะนํา) อนุญาตให้โหลดส่วนขยายใด ๆ โดยไม่มีการตรวจสอบความถูกต้องหรือคําเตือนตัวเลือกภายใต้ตัวเลือกไฟล์>และการตั้งค่า>ตัวเลือก>ส่วนขยายข้อมูลความปลอดภัย>
  3. รีสตาร์ต Power BI Desktop

Power BI Desktop จะโหลดส่วนขยายเมื่อรีสตาร์ทโดยอัตโนมัติ

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

Power Query Online

หมายเหตุ

ทีม Power Query กําลังทํางานอย่างหนักเพื่อเปิดใช้งานตัวเชื่อมต่อที่ได้รับการรับรองทั้งหมดของ Power Query ในประสบการณ์การใช้งาน Power Query Online

เฉพาะตัวเชื่อมต่อที่ได้รับการรับรองจาก Power Query เท่านั้นที่จะแสดงในประสบการณ์การใช้งาน Power Query Online เมื่อต้องการเรียนรู้เพิ่มเติมเกี่ยวกับโปรแกรมการรับรองตัวเชื่อมต่อ Power Query ไปที่การรับรองของ Power Query เชื่อมต่อ or