Bagikan melalui

Mengembangkan konektor menggunakan Power Query SDK

  • Artikel

Power Query SDK adalah sekumpulan alat yang dirancang untuk membantu Anda membuat konektor Power Query. Konektor ini sering disebut sebagai konektor kustom atau ekstensi Power Query.

Konektor kustom memungkinkan Anda membuat sumber data baru atau menyesuaikan dan memperluas sumber yang sudah ada. Kasus penggunaan umum meliputi:

  • Membuat tampilan ramah analis bisnis untuk REST API.
  • Menyediakan branding untuk sumber yang didukung Power Query dengan konektor yang sudah ada (seperti layanan OData atau driver ODBC).
  • Menerapkan alur autentikasi OAuth v2 untuk penawaran SaaS.
  • Mengekspos tampilan terbatas atau terfilter di atas sumber data Anda untuk meningkatkan kegunaan.
  • Mengaktifkan DirectQuery untuk sumber data menggunakan driver ODBC.

Menginstal Power Query SDK

Instal Visual Studio Code Power Query SDK dari bagian Visual Studio Code di Visual Studio Marketplace. Pilih Instal untuk menginstal SDK.

proses pengembangan Koneksi or

Bagian berikut ini menjelaskan, pada tingkat tinggi, proses paling umum untuk membuat konektor Power Query menggunakan SDK.

Membuat ekstensi baru

Saat membuat ruang kerja baru (Visual Studio Code Power Query SDK), Anda mulai dengan file inti berikut:

  • file definisi Koneksi or (<connectorName.pq>)
  • File kueri (<connectorName.query.pq>)
  • File sumber daya string (resources.resx)
  • File PNG dari berbagai ukuran yang digunakan untuk membuat ikon

File definisi konektor Anda akan dimulai dengan deskripsi sumber data kosong. Anda bisa mempelajari selengkapnya tentang sumber data dalam konteks Power Query SDK dari artikel tentang menangani akses data.

Pengujian

Power Query SDK menyediakan kemampuan eksekusi kueri dasar, memungkinkan Anda menguji ekstensi tanpa harus beralih ke Power BI Desktop.

File pengujian kueri

Selain file ekstensi, proyek Data Koneksi or dapat memiliki file kueri (name.query.pq). File ini dapat digunakan untuk menjalankan kueri pengujian dalam Visual Studio Code. Evaluasi kueri akan secara otomatis menyertakan kode ekstensi Anda, tanpa harus mendaftarkan file your.pqx, memungkinkan Anda untuk memanggil atau menguji fungsi bersama apa pun dalam kode ekstensi Anda.

File kueri bisa berisi ekspresi tunggal (misalnya, HelloWorld.Contents()), let ekspresi (seperti apa yang akan dihasilkan Power Query), atau dokumen bagian.

Membuat dan menyebarkan

Membangun proyek Anda menghasilkan file .mez atau file ekstensi Anda.

Ekstensi Power Query dibundel dalam file ZIP dan diberi ekstensi file .mez. Saat runtime, Power BI Desktop memuat ekstensi dari [Documents]\Microsoft Power BI Desktop\Custom Koneksi ors.

Catatan

Proyek data Koneksi or tidak mendukung langkah-langkah build posting kustom untuk menyalin file ekstensi ke direktori [Documents]\Microsoft Power BI Desktop\Custom Koneksi ors Anda. Jika ini adalah sesuatu yang ingin Anda lakukan, Anda mungkin ingin menggunakan ekstensi pihak ketiga.

Ekstensi ditentukan dalam dokumen bagian M. Dokumen bagian memiliki format yang sedikit berbeda dari dokumen kueri yang dihasilkan di Power Query. Kode yang Anda impor dari Power Query biasanya memerlukan modifikasi agar pas dengan dokumen bagian, tetapi perubahannya kecil. Perbedaan dokumen bagian yang harus Anda ketahui meliputi:

  • Mereka dimulai dengan deklarasi bagian (misalnya, section HelloWorld;).
  • Setiap ekspresi diakhir dengan titik koma (misalnya, a = 1; atau b = let c = 1 + 2 in c;).
  • Semua fungsi dan variabel bersifat lokal untuk dokumen bagian, kecuali ditandai sebagai dibagikan. Fungsi bersama menjadi terlihat oleh kueri/fungsi lain, dan dapat dianggap sebagai ekspor untuk ekstensi Anda (artinya, fungsi tersebut dapat dipanggil dari Power Query).

Informasi selengkapnya tentang dokumen bagian M dapat ditemukan dalam spesifikasi Bahasa M.

Distribusi konektor data

Konektor Power Query dapat digunakan di Power BI Desktop atau pengalaman Power Query Online, seperti aliran data Power BI, datamart Power BI, dan pengalaman lainnya.

Power BI Desktop

Pengguna Power BI Desktop dapat mengikuti langkah-langkah di bawah ini untuk menggunakan konektor kustom Power Query:

  1. Salin file ekstensi (.mez or.pqx) ke dalam [Documents]/Power BI Desktop/Custom Koneksi ors.
  2. Di Power BI Desktop, pilih opsi (Tidak Disarankan) Izinkan ekstensi apa pun dimuat tanpa validasi atau peringatan di bawah Opsi File>dan pengaturan>Opsi>Ekstensi Data Keamanan.>
  3. Mulai Power BI Desktop.

Power BI Desktop akan secara otomatis memuat ekstensi saat dimulai ulang.

Atau, sebagai pemilik sumber data dan konektor, Anda bisa mengirimkan konektor Anda ke program Sertifikasi Koneksi or Power Query sehingga dikirim dengan Power BI Desktop pada setiap rilis.

Power Query Online

Hanya konektor bersertifikat Power Query yang diperlihatkan dalam pengalaman Power Query Online. Untuk mempelajari selengkapnya tentang program sertifikasi konektor Power Query, buka Sertifikasi Power Query Koneksi or.