หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Power Query SDK เป็นชุดเครื่องมือที่ออกแบบมาเพื่อช่วยให้คุณสามารถสร้างตัวเชื่อมต่อ Power Query ได้ ตัวเชื่อมต่อเหล่านี้มักจะเรียกว่าตัวเชื่อมต่อแบบกําหนดเองหรือส่วนขยาย Power Query
ตัวเชื่อมต่อแบบกําหนดเองช่วยให้คุณสร้างแหล่งข้อมูลใหม่ หรือกําหนดเอง และขยายแหล่งข้อมูลที่มีอยู่ กรณีการใช้งานทั่วไปได้แก่:
- สร้างมุมมองที่เป็นมิตรกับนักวิเคราะห์ธุรกิจสําหรับ REST API
- การกําหนดตราสินค้าสําหรับแหล่งข้อมูลที่ Power Query สนับสนุนด้วยตัวเชื่อมต่อที่มีอยู่ (เช่น บริการ OData หรือโปรแกรมควบคุม ODBC)
- ใช้โฟลว์การรับรองความถูกต้อง OAuth v2 สําหรับข้อเสนอ SaaS
- การแสดงมุมมองที่จํากัดหรือกรองแล้วบนแหล่งข้อมูลของคุณเพื่อปรับปรุงความสามารถในการใช้งาน
- เปิดใช้งาน DirectQuery สําหรับแหล่งข้อมูลโดยใช้โปรแกรมควบคุม ODBC
การติดตั้ง Power Query SDK
ติดตั้ง Visual Studio Code Power Query SDK จากส่วน Visual Studio Code ของ Visual Studio Marketplace เลือก ติดตั้ง เพื่อติดตั้ง SDK
กระบวนการพัฒนาตัวเชื่อมต่อ
ส่วนต่อไปนี้อธิบายในระดับสูง กระบวนการทั่วไปในการสร้างตัวเชื่อมต่อ Power Query โดยใช้ SDK
การสร้างส่วนขยายใหม่
เมื่อสร้างพื้นที่ทํางานใหม่ (Visual Studio Code Power Query SDK) คุณจะเริ่มต้นด้วยไฟล์หลักต่อไปนี้:
- ไฟล์ข้อกําหนดของตัวเชื่อมต่อ (<connectorName.pq>)
- ไฟล์คิวรี (<connectorName.query.pq>)
- ไฟล์ทรัพยากรสตริง (resources.resx)
- ไฟล์ PNG ขนาดต่างๆ ที่ใช้ในการสร้างไอคอน
ไฟล์ข้อกําหนดตัวเชื่อมต่อของคุณเริ่มต้นด้วยคําอธิบายแหล่งข้อมูลที่ว่างเปล่า คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับแหล่งข้อมูลในบริบทของ Power Query SDK จากบทความเกี่ยวกับ การจัดการการเข้าถึงข้อมูล
การทดสอบ
Power Query SDK มีความสามารถในการดําเนินการคิวรีพื้นฐาน ช่วยให้คุณสามารถทดสอบส่วนขยายของคุณได้โดยไม่ต้องสลับไปยังแอปพลิเคชันไคลเอ็นต์อื่น คุณสามารถทดสอบตัวเชื่อมต่อของคุณเพิ่มเติมในแอปพลิเคชันเช่น:
- Power BI Desktop
ไฟล์ทดสอบคิวรี
นอกเหนือจากไฟล์นามสกุลแล้ว โครงการตัวเชื่อมต่อข้อมูลสามารถมีไฟล์คิวรี (name.query.pq) ได้ ไฟล์นี้สามารถใช้เพื่อเรียกใช้คิวรีทดสอบภายใน Visual Studio Code การประเมินผลคิวรีจะรวมโค้ดส่วนขยายของคุณโดยอัตโนมัติ โดยไม่จําเป็นต้องลงทะเบียนไฟล์ .pqx ของคุณ ช่วยให้คุณสามารถเรียกใช้หรือทดสอบฟังก์ชันที่ใช้ร่วมกันในโค้ดส่วนขยายของคุณได้
ไฟล์คิวรีสามารถมีนิพจน์เดียว (ตัวอย่างเช่น HelloWorld.Contents()) let นิพจน์ (เช่น สิ่งที่ Power Query จะสร้าง) หรือเอกสารส่วน
สร้างและปรับใช้งาน
การสร้างโครงการของคุณสร้างไฟล์ .mez หรือไฟล์นามสกุลของคุณ ส่วนขยาย Power Query จะรวมอยู่ในไฟล์ ZIP และกําหนดนามสกุลไฟล์ .mez
ส่วนขยายจะถูกกําหนดภายในเอกสารส่วน M เอกสารส่วนมีรูปแบบที่แตกต่างจากเอกสารคิวรีที่สร้างขึ้นใน Power Query เล็กน้อย โดยทั่วไป โค้ดที่คุณนําเข้าจาก Power Query จําเป็นต้องแก้ไขเพื่อให้พอดีกับเอกสารส่วน แต่การเปลี่ยนแปลงเป็นเพียงเล็กน้อย ความแตกต่างของเอกสารส่วนที่คุณควรทราบได้แก่:
- โดยเริ่มต้นด้วยการประกาศส่วน (ตัวอย่างเช่น
section HelloWorld;) - แต่ละนิพจน์ลงท้ายด้วยเครื่องหมายอัฒภาค (ตัวอย่างเช่น
a = 1;หรือb = let c = 1 + 2 in c;) - ฟังก์ชันและตัวแปรทั้งหมดจะอยู่ภายในเอกสารส่วน เว้นแต่จะมีการทําเครื่องหมายเป็นแชร์ ฟังก์ชันที่ใช้ร่วมกันจะมองเห็นได้สําหรับคิวรี/ฟังก์ชันอื่น ๆ และสามารถนึกภาพว่าเป็นการส่งออกสําหรับส่วนขยายของคุณ (นั่นคือคิวรี่นั้นสามารถเรียกใช้งานได้จาก Power Query)
ข้อมูลเพิ่มเติมเกี่ยวกับเอกสารส่วน M สามารถพบได้ในข้อมูลจําเพาะของภาษา M
การกระจายตัวเชื่อมต่อ Power Query ด้วยตนเอง
กลไกแบบบริการตนเองที่คุณสามารถใช้ตัวเชื่อมต่อแบบกําหนดเองของ Power Query ในประสบการณ์การใช้งานผลิตภัณฑ์ที่เกี่ยวข้อง
เมื่อสร้างตัวเชื่อมต่อของคุณแล้ว คุณสามารถส่งไฟล์นี้ได้ตามที่คุณต้องการสําหรับผู้ใช้ของคุณและพวกเขาสามารถใช้ตัวเชื่อมต่อในประสบการณ์การใช้งานผลิตภัณฑ์เช่น Microsoft Power BI ได้
Microsoft Power BI
คุณสามารถใช้ตัวเชื่อมต่อแบบกําหนดเองของคุณเองใน Microsoft Power BI Desktop และบริการของ Microsoft Power BI สําหรับแบบจําลองความหมายสําหรับการรีเฟรชและการเชื่อมต่อในระบบคลาวด์
ตัวเชื่อมต่อ Power Query สามารถโหลดเป็นสองประสบการณ์:
- เกตเวย์ข้อมูลภายในองค์กร: สามารถโหลดตัวเชื่อมต่อของคุณผ่านเกตเวย์ที่จะใช้ใน Microsoft Fabric และ Microsoft บริการของ Power BI s
- Power Query Desktop: ภายในประสบการณ์การใช้งานเช่น Power BI Desktop
คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับวิธีการใช้ตัวเชื่อมต่อแบบกําหนดเองของคุณสําหรับการแจกแจงด้วยตนเองโดยใช้บทความด้านล่าง:
- โหลดตัวเชื่อมต่อแบบกําหนดเองของ Power Query ใน Power BI Desktop
- เปิดใช้งานและใช้ตัวเชื่อมต่อแบบกําหนดเองในบริการของ Power BI