พัฒนาตัวเชื่อมต่อโดยใช้ Power Query SDK
Power Query SDK เป็นชุดเครื่องมือที่ออกแบบมาเพื่อช่วยให้คุณสามารถสร้างตัวเชื่อมต่อ Power Query ได้ ตัวเชื่อมต่อเหล่านี้มักจะเรียกว่าตัวเชื่อมต่อแบบกําหนดเองหรือส่วนขยาย Power Query
ตัวเชื่อมต่อแบบกําหนดเองช่วยให้คุณสร้างแหล่งข้อมูลใหม่ หรือกําหนดเอง และขยายแหล่งข้อมูลที่มีอยู่ กรณีการใช้งานทั่วไปได้แก่:
- สร้างมุมมองที่เป็นมิตรกับนักวิเคราะห์ธุรกิจสําหรับ REST API
- การกําหนดตราสินค้าสําหรับแหล่งข้อมูลที่ Power Query สนับสนุนด้วยตัวเชื่อมต่อที่มีอยู่ (เช่น บริการ OData หรือโปรแกรมควบคุม ODBC)
- ใช้โฟลว์การรับรองความถูกต้อง OAuth v2 สําหรับข้อเสนอ SaaS
- การแสดงมุมมองที่จํากัดหรือกรองแล้วบนแหล่งข้อมูลของคุณเพื่อปรับปรุงความสามารถในการใช้งาน
- เปิดใช้งาน DirectQuery สําหรับแหล่งข้อมูลโดยใช้โปรแกรมควบคุม ODBC
ติดตั้ง 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 มีความสามารถในการดําเนินการคิวรีพื้นฐาน ช่วยให้คุณสามารถทดสอบส่วนขยายของคุณได้โดยไม่ต้องสลับไปยังแอปพลิเคชันไคลเอ็นต์อื่น คุณสามารถทดสอบตัวเชื่อมต่อของคุณเพิ่มเติมในแอปพลิเคชันเช่น:
นอกเหนือจากไฟล์นามสกุลแล้ว โครงการตัวเชื่อมต่อข้อมูลสามารถมีไฟล์คิวรี (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 ในประสบการณ์การใช้งานผลิตภัณฑ์ที่เกี่ยวข้อง
เมื่อสร้างตัวเชื่อมต่อของคุณแล้ว คุณสามารถส่งไฟล์นี้ได้ตามที่คุณต้องการสําหรับผู้ใช้ของคุณและพวกเขาสามารถใช้ตัวเชื่อมต่อในประสบการณ์การใช้งานผลิตภัณฑ์เช่น Microsoft Power BI ได้
คุณสามารถใช้ตัวเชื่อมต่อแบบกําหนดเองของคุณเองใน Microsoft Power BI Desktop และบริการของ Microsoft Power BI สําหรับแบบจําลองความหมายสําหรับการรีเฟรชและการเชื่อมต่อในระบบคลาวด์
ตัวเชื่อมต่อ Power Query สามารถโหลดลงในประสบการณ์สามประการ:
- เกตเวย์ข้อมูลภายในองค์กร: สามารถโหลดตัวเชื่อมต่อของคุณผ่านเกตเวย์ที่จะใช้ใน Microsoft Fabric และ Microsoft บริการของ Power BI s
- Power Query Online: ภายในประสบการณ์การใช้งาน เช่น Power BI Datamarts, Fabric Dataflow Gen2 และอื่น ๆ อีกมากมาย
- Power Query Desktop: ภายในประสบการณ์การใช้งานเช่น Power BI Desktop
คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับวิธีการใช้ตัวเชื่อมต่อแบบกําหนดเองของคุณสําหรับการแจกแจงด้วยตนเองโดยใช้บทความด้านล่าง:
- โหลดตัวเชื่อมต่อแบบกําหนดเองของ Power Query ใน Power BI Desktop
- เปิดใช้งานและใช้ตัวเชื่อมต่อแบบกําหนดเองในบริการของ Power BI
โปรแกรมการรับรองตัวเชื่อมต่อ Data Factory ช่วยให้คุณสามารถส่งตัวเชื่อมต่อของคุณไปยัง Microsoft เพื่อขอการรับรองซึ่ง Microsoft จะดูแลการเผยแพร่และแจกจ่ายตัวเชื่อมต่อของคุณภายในทั้ง Microsoft Fabric และ Microsoft Power BI สําหรับผลิตภัณฑ์และประสบการณ์การใช้งานที่เกี่ยวข้อง:
- Power Query Desktop: Microsoft Power BI Desktop
- Power Query ออนไลน์: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 และอื่น ๆ
- เกตเวย์ข้อมูลภายในองค์กร: สําหรับทั้ง Microsoft Fabric และ Microsoft Power BI ที่ใช้เกตเวย์สําหรับรีเฟรชหรือการเชื่อมต่อที่ผ่านการรับรองความถูกต้อง
เรียนรู้เพิ่มเติมเกี่ยวกับโปรแกรมการรับรองตัวเชื่อมต่อ Data Factory