ภาพรวม Power Query SDK

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

สร้างโครงการใหม่

เคล็ดลับ

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

เมื่ออยู่ในรหัส Visual Studio ในแผง Explorer หลักของ Visual Studio Code จะมีส่วนที่มีชื่อว่า Power Query SDK ส่วนนี้มีปุ่มเดียวเท่านั้นที่อ่าน สร้างโครงการส่วนขยาย เลือกปุ่มนี้

ปุ่มนี้จะเปิดเขตข้อมูลป้อนเข้าที่ด้านบนของอินเทอร์เฟซ Visual Studio Code ป้อนชื่อของโครงการส่วนขยายใหม่ของคุณ จากนั้นเลือก Enter

หลังจากนั้นไม่กี่วินาที หน้าต่าง Visual Studio Code ของคุณจะเปิดไฟล์ *.pq หลักสําหรับโครงการส่วนขยายของคุณที่มีตรรกะตัวเชื่อมต่อของคุณ Power Query SDK จะเรียกใช้งานที่จําเป็นบางอย่างโดยอัตโนมัติเพื่อดําเนินการตั้งค่าพื้นที่ทํางานของคุณให้เสร็จสมบูรณ์ คุณสามารถตรวจสอบงานเหล่านี้ได้ในคอนโซลเอาต์พุตใน Visual Studio Code

Power Query SDK จะสร้างชุดไฟล์ต่อไปนี้โดยอัตโนมัติ:

• ไฟล์ settings.json ที่กําหนดการตั้งค่าเฉพาะให้ทํางานในระดับพื้นที่ทํางานของคุณ
• ซึ่งจะสร้างส่วนขยายเป็น ไฟล์ .mez และเก็บไว้ในช่องเก็บใหม่\AnyCPU\Debug โฟลเดอร์
• ชุดของไอคอนตัวเชื่อมต่อเป็นไฟล์.png
• ไฟล์ resources.resx ที่ทําหน้าที่เป็นที่เก็บหลักสําหรับสตริงที่ใช้ในส่วนขยาย
• ไฟล์ .pq ที่มีตรรกะหลักของส่วนขยายหรือตัวเชื่อมต่อของคุณ
• ไฟล์ .query.pq ที่มีวัตถุประสงค์หลักถูกใช้เป็นวิธีในการสร้างคิวรีทดสอบที่คุณสามารถประเมินได้ในภายหลัง
• แฟ้ม .proj ที่เก็บข้อมูลเกี่ยวกับโครงการส่วนขยาย

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

ข้อมูลประจำตัว

สำคัญ

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

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

ตั้งค่าข้อมูลประจําตัว

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

• ผ่านรายการในส่วน Power Query SDK ในบานหน้าต่าง explorer

  

• ผ่านเทอร์มินัลโดยการเลือกตัวเลือก เรียกใช้งาน จากนั้นเลือกตัวเลือก ตั้งค่าข้อมูลประจําตัว

  

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

1. เลือกชนิดแหล่งข้อมูล
2. เลือกไฟล์ตัวเชื่อมต่อ
3. เลือกวิธีการรับรองความถูกต้อง

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

แสดงข้อมูลประจําตัว

คล้ายกับการตั้งค่าข้อมูลประจําตัว งานที่แสดงรายการข้อมูลประจําตัวมีจุดเข้าใช้งานสองจุดในสถานที่เดียวกัน: ส่วน Power Query SDK ในบานหน้าต่าง Explorer และภายในเมนูเทอร์มินัล

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

ล้างข้อมูลประจําตัวทั้งหมด

คล้ายกับงานสองงานก่อนหน้านี้ งานจะล้างข้อมูลประจําตัวทั้งหมดมีจุดเข้าใช้งานสองจุดในตําแหน่งเดียวกัน: ส่วน Power Query SDK ในบานหน้าต่าง Explorer และภายในเมนูเทอร์มินัล

งานนี้ทําหน้าที่เป็นวิธีล้างข้อมูลประจําตัวทั้งหมดจากเซสชันปัจจุบันของคุณเมื่อคุณต้องการตั้งค่าข้อมูลประจําตัวใหม่เพื่อประเมินคิวรีของคุณ

ข้อความให้ข้อมูลสําหรับงานนี้ยังแสดงอยู่ในคอนโซลเอาต์พุต

ประเมินคิวรีและแผงผลลัพธ์

ก่อนที่คุณจะสามารถประเมินคิวรีทดสอบใด ๆ ต้องตั้งค่าข้อมูลประจําตัวก่อน การใช้ตัวเชื่อมต่อที่สร้างขึ้นในส่วนก่อนหน้านี้ คุณสามารถเปิด *.query.pq ไฟล์ที่ทําหน้าที่เป็นไฟล์คิวรีทดสอบของคุณได้

สําหรับตัวเชื่อมต่อเฉพาะนี้ที่ชื่อโครงการเป็น MyConnector โค้ดจะมีลักษณะดังนี้:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents()
in
    result

ก่อนที่จะประเมินคิวรี ให้มาเปลี่ยนโค้ดดังต่อไปนี้:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents("Hello World")
in
    result

ตรวจสอบให้แน่ใจว่าได้บันทึกไฟล์หลังจากเปลี่ยนรหัสแล้ว

ในการประเมินคิวรีนี้ คุณมีสามตัวเลือก:

• คลิกขวาที่ไฟล์ที่ใช้งานอยู่และเลือกตัวเลือก ประเมินไฟล์ power query ปัจจุบัน

• ไปที่เมนูเทอร์มินัล และเลือกงาน ประเมินไฟล์ปัจจุบัน

• ใช้การเรียกใช้แบบดั้งเดิม และดีบัก ตัวเลือกจาก Visual Studio Code เลือกการเชื่อมโยงหลายมิติเพื่อสร้างไฟล์ launch.json แล้วประเมินไฟล์

หลังจากประเมินคิวรีแล้ว ผลลัพธ์จะแสดงในคอนโซลที่ด้านล่างของหน้าต่างและในแผงใหม่ที่เรียกว่า แผงผลลัพธ์ ทางด้านขวา

แผงผลลัพธ์ประกอบด้วยสามแท็บ:

• แท็บผลลัพธ์: แสดงตัวอย่างข้อมูลของคิวรีที่มีการประเมิน ถ้าข้อมูลเป็นตาราง ข้อมูลจะแสดงเป็นตาราง

  

• สรุป: แสดงข้อมูลสรุปของกิจกรรมที่เรียกใช้การประเมินผล พร้อมกับสถิติที่เกี่ยวข้องกับกิจกรรมนั้น

  

• DataSource: แสดงข้อมูลทั่วไปเกี่ยวกับแหล่งข้อมูลที่ใช้สําหรับการประเมิน

  

ในการประเมินคิวรีอื่น คุณเพียงแค่ปรับเปลี่ยนไฟล์ *.query.pq บันทึกและจากนั้นเรียกใช้งานการประเมินผลอีกครั้งด้วยวิธีใดวิธีหนึ่งจากสามวิธี

หมายเหตุ

Power Query SDK ไม่จัดการกลไกการแคชทุกชนิดสําหรับการประเมิน

นําโครงการส่วนขยายดั้งเดิมไปยัง SDK ใหม่

ส่วนนี้ช่วยให้นักพัฒนาตัวเชื่อมต่อที่มีโครงการส่วนขยายที่สร้างขึ้นด้วย Visual Studio จาก Power Query SDK แบบดั้งเดิม

เพื่อทําตาม เราขอแนะนําให้ดาวน์โหลดโครงการตัวเชื่อมต่อที่พร้อมใช้งานจากที่เก็บ DataConnectors ของเรา สําหรับตัวอย่าง TripPin โดยเฉพาะตัวอย่าง 9-TestConnection

หากต้องการนําโครงการส่วนขยายดั้งเดิมไปยัง SDK ใหม่ ให้ทําตามขั้นตอนเหล่านี้:

1. ในรหัส Visual Studio เลือกไฟล์>เปิดโฟลเดอร์ แล้วนําทางไปยังโฟลเดอร์ที่โครงการส่วนขยายของคุณอยู่

2. ตั้งค่าพื้นที่ทํางานโดยใช้โฟลเดอร์ที่มีอยู่และเนื้อหาโดยใช้หนึ่งในสองวิธีต่อไปนี้:

   • Power Query SDK มีกลไกในการจดจําเนื้อหาของโฟลเดอร์ของคุณ และแนะนําให้คุณเปิดใช้งานการแปลงเป็นพื้นที่ทํางาน Power Query SDK ใหม่

     

   • เรียกใช้พื้นที่ทํางานการตั้งค่าและสร้างงานจากเมนูเทอร์มินัล สิ่งเหล่านี้จะสร้างไฟล์ .mez และไฟล์ settings.json ที่จําเป็นสําหรับพื้นที่ทํางานได้อย่างมีประสิทธิภาพ

การเพิ่มโฟลเดอร์และไฟล์ใหม่สองรายการคือ สิ่งที่จะแปลงพื้นที่ทํางานปัจจุบันเป็นพื้นที่ทํางาน Power Query SDK ใหม่

ตั้งค่าพื้นที่ทํางาน

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

สร้างไฟล์ส่วนขยาย

งานรุ่นช่วยให้คุณสามารถสร้างไฟล์ .mez สําหรับส่วนขยายของคุณตามความต้องการ

เรียกใช้ฟังก์ชัน TestConnection

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

งานที่จะเรียกใช้ TestConnection ช่วยให้คุณสามารถทดสอบตัวจัดการภายใน Power Query SDK ได้โดยไม่ต้องลองใช้ตัวจัดการนี้ด้วยตนเองใน Microsoft Cloud

เมื่อต้องการเรียกใช้งานนี้ ก่อนอื่นให้ตั้งค่าข้อมูลประจําตัวสําหรับตัวเชื่อมต่อของคุณ จากนั้นเรียกใช้งานจาก ส่วน Power Query SDK ใน Explorer หรือผ่านรายการงานภายในเมนูเทอร์มินัล

ผลลัพธ์ของงานนี้จะแสดงในเทอร์มินัลเอาต์พุตที่ด้านล่างของหน้าต่าง

คําติชมและบัก

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

คุณยังสามารถใช้ฟอรัมชุมชน Power BI เพื่อโพสต์คําถามทั่วไปเกี่ยวกับ Power Query ภาษา M และการพัฒนาตัวเชื่อมต่อแบบกําหนดเอง