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 konektor

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 konektor (<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 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 aplikasi klien yang berbeda. Anda dapat menguji konektor Anda lebih lanjut dalam aplikasi seperti:

File pengujian kueri

Selain file ekstensi, proyek Konektor Data 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.

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 Power Query

Anda memiliki dua jalur di mana Anda dapat mendistribusikan konektor Anda:

  • Distribusi mandiri
  • Sertifikasi konektor

Distribusi mandiri

Mekanisme layanan mandiri tempat Anda dapat menerapkan konektor kustom Power Query dalam pengalaman produk yang berlaku

Dengan konektor Anda dibuat, Anda dapat mengirim file ini sesuai keinginan Anda kepada pengguna Anda dan mereka dapat menggunakan konektor dalam pengalaman produk yang berlaku seperti Microsoft Power BI.

Microsoft Power BI

Anda bisa menggunakan konektor kustom Anda sendiri di Microsoft Power BI Desktop dan Layanan Microsoft Power BI untuk model Semantik untuk refresh dan konektivitas di cloud.

Konektor Power Query dapat dimuat ke dalam tiga pengalaman:

  • Gateway Data Lokal: Konektor Anda dapat dimuat melalui gateway yang akan digunakan di Microsoft Fabric dan Microsoft layanan Power BI s
  • Power Query Online: dalam pengalaman seperti Power BI Datamarts, Fabric Dataflow Gen2, dan banyak lainnya
  • Power Query Desktop: dalam pengalaman seperti Power BI Desktop.

Anda dapat mempelajari selengkapnya tentang cara menggunakan konektor kustom Anda untuk distribusi mandiri menggunakan artikel di bawah ini:

Sertifikasi Konektor

Program sertifikasi konektor Data Factory memungkinkan Anda mengirimkan konektor Anda ke Microsoft untuk sertifikasi di mana Microsoft mengurus penerbitan dan distribusi konektor Anda dalam Microsoft Fabric dan Microsoft Power BI untuk produk dan pengalaman yang berlaku:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1, dan lainnya
  • Gateway Data lokal: Untuk Microsoft Fabric dan Microsoft Power BI yang menggunakan gateway untuk refresh atau konektivitas terautentikasi.

Pelajari selengkapnya tentang program Sertifikasi Konektor Data Factory.