Gambaran Umum Power Query SDK

Tujuan artikel ini adalah untuk memberi Anda gambaran umum tentang kemampuan keseluruhan dan pengalaman pengembangan yang ditemukan di dalam Power Query SDK untuk Visual Studio Code.

Membuat proyek baru

Setelah berada di Visual Studio Code, di panel Penjelajah utama Visual Studio Code ada bagian dengan nama Power Query SDK. Bagian ini hanya memiliki satu tombol yang membaca Membuat proyek ekstensi. Pilih tombol ini.

Tombol ini membuka bidang input di bagian atas antarmuka Visual Studio Code. Masukkan nama proyek ekstensi baru Anda, lalu pilih Enter.

Setelah beberapa detik, jendela Visual Studio Code Anda membuka file *.pq utama untuk proyek ekstensi Anda yang berisi logika konektor Anda. Power Query SDK secara otomatis menjalankan beberapa tugas yang diperlukan untuk menyelesaikan penyiapan ruang kerja Anda. Anda dapat memeriksa tugas-tugas ini di konsol output di Visual Studio Code.

Power Query SDK secara otomatis membuat kumpulan file berikut:

• File settings.json yang menentukan pengaturan tertentu untuk dikerjakan di tingkat ruang kerja Anda.
• Ini membangun ekstensi sebagai file .mez dan menyimpannya di folder bin\AnyCPU\Debug baru.
• Sekumpulan ikon konektor sebagai file .png.
• File resources.resx yang berfungsi sebagai penyimpanan utama untuk string yang digunakan dalam ekstensi.
• File .pq yang menyimpan logika utama ekstensi atau konektor Anda.
• File .query.pq yang tujuan utamanya adalah digunakan sebagai cara untuk membuat kueri pengujian yang nantinya dapat Anda evaluasi.
• File .proj yang menyimpan informasi tentang proyek ekstensi.

Setelah proyek ekstensi dikenali oleh Visual Studio Code, bagian untuk Power Query SDK mengubah tampilannya, dan sekarang menampilkan daftar tugas yang dapat Anda jalankan terhadap proyek ekstensi baru Anda.

Informasi Masuk

Power Query SDK menawarkan beberapa tugas melalui antarmuka penggunanya untuk memungkinkan Anda mengatur, mencantumkan, dan menghapus kredensial dari proyek ekstensi Anda.

Mengatur kredensial

Power Query SDK terutama didorong oleh tugas yang dapat dipicu melalui beberapa titik masuk. Mengatur kredensial dapat dilakukan dengan dua cara (tugas kredensial lainnya dapat dilakukan dengan cara yang sama).

• Melalui entri di bagian Power Query SDK di panel penjelajah.

  

• Melalui Terminal dengan memilih opsi Jalankan Tugas lalu pilih tugas Atur kredensial.

  

Saat Anda menjalankan tugas ini, Visual Studio Code akan memandu Anda melalui serangkaian perintah untuk memungkinkan Anda mengatur kredensial. Serangkaian perintah ini dapat diprediksi dan selalu terdiri dari tahap yang sama:

1. Pilih jenis sumber data.
2. Pilih file konektor.
3. Pilih metode autentikasi.

Untuk proyek ekstensi yang ada, metode autentikasi yang tersedia bersifat anonim. Setelah autentikasi diatur, pesan yang mengonfirmasi kredensial telah berhasil dihasilkan ditampilkan di sudut kanan bawah jendela.

Mencantumkan kredensial

Mirip dengan mengatur kredensial, tugas untuk mencantumkan kredensial memiliki dua titik entri di tempat yang sama: bagian Power Query SDK di panel Explorer dan di dalam menu Terminal .

Ketika tugas ini dijalankan, tugas ini menampilkan kredensial yang tersedia di dalam terminal output.

Menghapus SEMUA kredensial

Mirip dengan dua tugas sebelumnya, tugas untuk menghapus semua kredensial memiliki dua titik entri di tempat yang sama: bagian Power Query SDK di panel Explorer dan di dalam menu Terminal .

Tugas ini berfungsi sebagai cara untuk menghapus semua kredensial dari sesi Anda saat ini saat Anda perlu mengatur kredensial baru untuk mengevaluasi kueri Anda.

Pesan informasi untuk tugas ini juga ditampilkan di konsol output.

Mengevaluasi kueri dan panel hasil

Sebelum Anda dapat mengevaluasi kueri pengujian apa pun, kredensial harus diatur. Dengan menggunakan konektor yang dibuat di bagian sebelumnya, Anda dapat membuka *.query.pq file yang berfungsi sebagai file kueri pengujian Anda.

Untuk konektor khusus ini di mana nama proyek adalah MyConnector, kode terlihat sebagai berikut:

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

Sebelum mengevaluasi kueri, mari kita ubah kode sebagai berikut:

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

Pastikan untuk menyimpan file setelah mengubah kodenya.

Untuk mengevaluasi kueri ini, Anda memiliki tiga opsi:

• Pilih kanan file yang sedang digunakan dan pilih opsi Evaluasi file kueri daya saat ini.

• Buka menu Terminal dan pilih tugas Evaluasi file saat ini.

• Gunakan opsi Jalankan dan Debug asli dari Visual Studio Code, pilih hyperlink untuk membuat file launch.json, lalu evaluasi file.

Setelah mengevaluasi kueri, hasilnya ditampilkan di konsol di bagian bawah jendela dan di panel baru yang disebut panel hasil di sebelah kanan.

Panel hasil berisi tiga tab:

• Tab Output: Menampilkan pratinjau data kueri yang dievaluasi. Jika data adalah tabel, data ditampilkan sebagai kisi.

  

• Ringkasan: Menampilkan ringkasan aktivitas yang menjalankan evaluasi, bersama dengan statistik yang terkait dengan aktivitas tersebut.

  

• DataSource: Menampilkan informasi umum tentang sumber data yang digunakan untuk evaluasi.

  

Untuk mengevaluasi kueri yang berbeda, Anda cukup memodifikasi file *.query.pq, menyimpannya, lalu menjalankan tugas evaluasi lagi dengan salah satu dari tiga metode.

Membawa proyek ekstensi warisan ke SDK baru

Bagian ini membantu pengembang konektor yang memiliki proyek ekstensi yang dibuat dengan Power Query SDK berbasis Visual Studio warisan.

Untuk mengikutinya, sebaiknya unduh proyek konektor yang tersedia dari repositori DataConnectors kami untuk sampel TripPin, khususnya sampel 9-TestConnection.

Untuk membawa proyek ekstensi warisan ke SDK baru, ikuti langkah-langkah berikut:

1. Di Visual Studio Code, pilih Folder Buka File>, lalu navigasikan ke folder tempat proyek ekstensi Anda berada.

2. Siapkan ruang kerja menggunakan folder yang sudah ada dan kontennya menggunakan salah satu dari dua metode berikut:

   • Power Query SDK memiliki mekanisme untuk mengenali konten folder Anda dan menyarankan agar Anda mengaktifkan konversi ke ruang kerja Power Query SDK baru.

     

   • Jalankan ruang kerja Penyiapan dan Tugas Build dari menu terminal. Ini akan secara efektif membuat file .mez dan file settings.json yang diperlukan untuk ruang kerja.

Penambahan dua folder dan file baru adalah yang mengubah ruang kerja saat ini menjadi ruang kerja Power Query SDK baru.

Menyiapkan ruang kerja

Apa yang dilakukan tugas Siapkan ruang kerja secara efektif membuat file settings.json untuk ruang kerja Anda yang menentukan beberapa variabel yang akan digunakan untuk ruang kerja Anda dalam hal evaluasi dan pengaturan umum.

Membangun file ekstensi

Tugas build memungkinkan Anda membuat file .mez untuk ekstensi Anda sesuai permintaan.

Menjalankan fungsi TestConnection

TestConnection adalah fungsi yang memungkinkan konektor Anda di-refresh di Microsoft Cloud melalui layanan seperti Power BI. Ini adalah catatan yang diimplementasikan di dalam rekaman sumber data konektor Anda. Anda dapat mempelajari selengkapnya tentang implementasi handler TestConnection dari sampel yang tersedia untuk Koneksi pengujian.

Tugas untuk menjalankan TestConnection memungkinkan Anda menguji handler di dalam Power Query SDK tanpa harus mencoba handler ini secara manual di Microsoft Cloud.

Untuk menjalankan tugas ini, pertama-tama atur kredensial untuk konektor Anda lalu jalankan tugas baik dari bagian Power Query SDK di Explorer atau melalui daftar tugas di dalam menu terminal.

Hasil tugas ini ditampilkan di terminal output di bagian bawah jendela.

Umpan balik dan bug

Jika Anda memerlukan bantuan untuk mengembangkan konektor kustom Anda atau memiliki umpan balik, saran, atau bug yang ingin Anda laporkan, kunjungi repositori publik resmi kami di GitHub.

Anda juga dapat menggunakan forum Komunitas Power BI untuk memposting pertanyaan umum sekeliling Power Query, bahasa M, dan pengembangan konektor kustom.