Bagikan melalui

Sertifikasi Koneksi or Power Query

  • Artikel

Catatan

Artikel ini menjelaskan persyaratan dan proses untuk mengirimkan konektor kustom Power Query untuk sertifikasi. Baca seluruh artikel secara dekat sebelum memulai proses sertifikasi.

Pendahuluan

Dengan Power Query SDK, semua orang diberdayakan untuk membuat konektor Power Query kustom untuk menyambungkan ke sumber data dari Power Query. Saat ini, konektor kustom hanya didukung dalam model semantik Power BI (Power BI Desktop dan layanan Power BI), dan memerlukan penggunaan gateway data lokal untuk di-refresh melalui layanan Power BI. Konektor kustom perlu didistribusikan secara individual oleh pengembang.

Pemilik sumber data yang mengembangkan konektor kustom untuk sumber data mereka mungkin ingin mendistribusikan konektor kustom mereka secara lebih luas kepada pengguna Power Query. Setelah konektor kustom dibuat, digunakan, dan divalidasi oleh pengguna akhir, pemilik sumber data dapat mengirimkannya untuk sertifikasi Microsoft.

Mensertifikasi konektor kustom Power Query membuat konektor tersedia secara publik, siap pakai, dalam model semantik Power BI (Power BI Desktop dan layanan Power BI), aliran data Power BI, dan datamart Power BI. Konektor bersertifikat didukung di PowerBI.com dan semua versi Power BI Premium.

Konektor bersertifikat adalah:

  • Dikelola oleh pengembang mitra

  • Didukung oleh pengembang mitra

  • Disertifikasi oleh Microsoft

  • Didistribusikan oleh Microsoft

Kami bekerja dengan mitra untuk mencoba memastikan bahwa mereka memiliki dukungan dalam pemeliharaan, tetapi masalah pelanggan dengan konektor itu sendiri akan diarahkan ke pengembang mitra.

Perbedaan konektor bersertifikat dan konektor kustom

Konektor bersertifikat dibundel secara langsung di Power BI Desktop, dan disebarkan ke Layanan Power BI, aliran data Power BI, dan datamart Power BI. Konektor kustom hanya didukung dalam model semantik Power BI dan perlu dimuat di Power BI Desktop, seperti yang dijelaskan dalam Memuat ekstensi Anda di Power BI Desktop. Konektor bersertifikat dan kustom dapat disegarkan melalui Power BI Desktop atau Layanan Power BI melalui menggunakan gateway data lokal dengan menerapkan Pengujian Koneksi ion. Gateway data lokal diperlukan untuk konektor kustom.

Konektor bersertifikat di Power BI Desktop dengan TestConnection implementasi juga mendukung refresh end-to-end melalui cloud (Layanan Power BI) tanpa memerlukan gateway data lokal. Lingkungan layanan Power BI pada dasarnya menghosting "gateway cloud" yang berjalan mirip dengan gateway lokal. Setelah sertifikasi, kami menyebarkan konektor Anda ke lingkungan ini sehingga tersedia untuk semua pelanggan Power BI.

Konektor kustom dan bersertifikat dengan komponen tambahan (misalnya, driver ODBC) memerlukan komponen tambahan untuk diinstal pada komputer pengguna akhir dan memerlukan gateway data lokal, kecuali komponen tambahan disebarkan ke cloud Power BI. Saat ini, kami tidak mensertifikasi dan menyebarkan komponen tambahan baru ke cloud Power BI, sehingga sertifikasi konektor dengan dependensi pada komponen tambahan tidak akan menghapus persyaratan gateway data lokal.

Distribusi konektor kustom

Konektor kustom dapat dan harus didistribusikan ke pengguna akhir sebelum sertifikasi.

Karena M adalah bahasa serbaguna yang, seperti yang terlihat dalam Menangani Autentikasi, memiliki kapasitas untuk berinteraksi dengan kredensial tersimpan, kita perlu memberi pengguna cara untuk hanya mengizinkan konektor tepercaya untuk dijalankan.

Dari perspektif pengembang, pengembang perlu menandatangani sendiri konektor kustom mereka dan memberi pengguna mereka informasi (thumbprint) untuk memuatnya dengan aman.

Dari perspektif pengguna, pengguna perlu menggunakan thumbprint dari pengembang untuk mempercayai dan memuat konektor kustom dengan aman untuk digunakan. Atau, pengguna dapat memilih untuk menurunkan pengaturan keamanan mereka untuk memungkinkan pemuatan kode tidak disertifikasi oleh Microsoft atau pengembang lain, tetapi opsi ini tidak disarankan.

Gambaran Umum Sertifikasi

Prasyarat

Untuk memastikan pengalaman terbaik bagi pelanggan kami, kami hanya mempertimbangkan konektor yang memenuhi serangkaian prasyarat untuk sertifikasi:

  • Konektor harus untuk produk publik.

  • Konektor harus dianggap lengkap kode untuk versi rilis awal. Program ini memungkinkan perulangan dan pembaruan yang sering. Perhatikan bahwa Microsoft tidak menawarkan bantuan teknis atau konsultasi pengembangan konektor kustom. Sebaiknya manfaatkan sumber daya publik seperti dokumentasi SDK dan repositori sampel kami. Jika Anda memerlukan bantuan lebih lanjut, kami dapat berbagi daftar konsultan pengembangan konektor kustom industri pihak ke-3 yang diketahui yang mungkin ingin Anda libatkan secara langsung, terpisah dari program atau kemitraan Microsoft mana pun. Perhatikan bahwa Microsoft tidak berafiliasi dengan salah satu konsultan ini dan tidak bertanggung jawab atas penggunaan layanan mereka oleh Anda. Microsoft menyediakan daftar untuk kenyamanan Anda dan tanpa jaminan, rekomendasi, atau jaminan apa pun. Hubungi kontak sertifikasi Microsoft Anda untuk mempelajari lebih lanjut.

  • Pengembang harus memberikan perkiraan untuk penggunaan. Kami menyarankan agar pengembang konektor untuk produk yang sangat butik menggunakan kemampuan penandatanganan diri konektor kami untuk menyediakannya langsung kepada pelanggan.

  • Konektor harus sudah tersedia untuk pelanggan secara langsung untuk memenuhi kebutuhan pengguna atau skenario bisnis. Kriteria ini dapat dipenuhi menggunakan program Pratinjau Privat dengan mendistribusikan konektor yang diselesaikan langsung ke pengguna akhir dan organisasi melalui penandatanganan mandiri. Setiap pengguna atau organisasi harus dapat memberikan umpan balik dan validasi bahwa ada kebutuhan bisnis untuk konektor dan bahwa konektor berhasil bekerja untuk memenuhi persyaratan bisnis mereka.

  • Konektor harus berhasil bekerja pada tingkat penggunaan yang diantisipasi oleh pelanggan.

  • Harus ada utas di forum Ide Power BI yang didorong oleh pelanggan untuk menunjukkan permintaan agar konektor tersedia untuk umum di Power BI Desktop. Tidak ada ambang batas keterlibatan yang ditetapkan. Namun semakin banyak keterlibatan, semakin kuat permintaan yang dibuktikan untuk konektor.

Prasyarat ini ada untuk memastikan bahwa konektor yang menjalani sertifikasi memiliki pelanggan dan bisnis yang signifikan perlu digunakan dan didukung pasca-sertifikasi.

Proses dan Garis Waktu

Konektor bersertifikat dirilis dengan rilis Power BI Desktop bulanan, sehingga tenggat waktu untuk setiap rilis berfungsi kembali dari setiap tanggal rilis Power BI Desktop. Durasi proses sertifikasi yang diharapkan dari pendaftaran ke rilis bervariasi tergantung pada kualitas dan kompleksitas pengiriman konektor. Microsoft tidak memberikan jaminan garis waktu tertentu sehubungan dengan tinjauan dan persetujuan konektor apa pun. Tenggat waktu yang sulit untuk setiap tinjauan konektor diuraikan dalam langkah-langkah berikut, tetapi Microsoft tidak menjamin kepatuhan terhadap garis waktu ini.

  • Pendaftaran: pemberitahuan niat untuk mensertifikasi konektor kustom Anda. Pendaftaran ini harus terjadi pada tanggal 15 bulan, dua bulan sebelum rilis desktop Power BI yang ditargetkan.

    • Misalnya, untuk rilis Power BI Desktop April, tenggat waktunya adalah 15 Februari.

  • Pengiriman: pengiriman file konektor untuk peninjauan Microsoft. Pengiriman ini harus terjadi pada tanggal 1 bulan sebelum rilis desktop Power BI yang ditargetkan.

    • Misalnya, untuk rilis Power BI Desktop April, tenggat waktunya adalah 1 Maret.

  • Tinjauan Teknis: finalisasi file konektor, melewati tinjauan dan sertifikasi Microsoft. Tinjauan ini harus terjadi pada tanggal 15 bulan sebelum rilis Power BI Desktop yang ditargetkan.

    • Misalnya, untuk rilis Power BI Desktop April, tenggat waktunya adalah 15 Maret.

Karena kompleksitas tinjauan teknis dan potensi keterlambatan, rearchitecture, dan masalah pengujian, kami sangat menyarankan untuk mengirimkan lebih awal dengan waktu tunggu yang lama untuk rilis awal dan sertifikasi. Jika Anda merasa konektor Anda penting untuk dikirimkan ke beberapa pelanggan dengan overhead minimal, kami sarankan penandatanganan mandiri dan menyediakannya seperti itu.

Persyaratan Sertifikasi

Kami memiliki serangkaian persyaratan tertentu untuk sertifikasi. Kami menyadari bahwa tidak setiap pengembang dapat memenuhi persyaratan ini, dan kami berharap untuk memperkenalkan set fitur yang akan menangani kebutuhan pengembang dalam urutan singkat.

File Pengiriman (Artefak)

Pastikan file konektor yang Anda kirimkan menyertakan semua hal berikut:

  • file Koneksi or (.mez)

    • File .mez harus mengikuti standar gaya dan diberi nama yang mirip dengan nama produk atau layanan. Ini tidak boleh menyertakan kata-kata seperti "Power BI", "Koneksi or" atau "API".
    • Beri nama file .mez: ProductName.mez

  • File Power BI Desktop (.pbix) untuk pengujian

    • Kami memerlukan sampel laporan Power BI (.pbix) untuk menguji konektor Anda.
    • Laporan harus menyertakan setidaknya satu kueri untuk menguji setiap item dalam tabel navigasi Anda.
    • Jika tidak ada skema yang ditetapkan (misalnya, database), laporan perlu menyertakan kueri untuk setiap "jenis" tabel yang dapat ditangani konektor.

  • Menguji akun ke sumber data Anda

    • Kami menggunakan akun pengujian untuk menguji dan memecahkan masalah konektor Anda.
    • Berikan akun pengujian yang persisten, sehingga kami dapat menggunakan akun yang sama untuk mensertifikasi pembaruan di masa mendatang.

  • Instruksi pengujian

    • Berikan dokumentasi tentang cara menggunakan konektor dan menguji fungsionalitasnya.

  • Tautan ke dependensi eksternal (misalnya, driver ODBC)

Fitur dan Gaya

Konektor harus mengikuti serangkaian aturan fitur dan gaya untuk memenuhi standar kegunaan yang konsisten dengan konektor bersertifikat lainnya.

  • Konektor HARUS:

    • Gunakan format dokumen Bagian.
    • Berisi header/hiasan versi di atas dokumen bagian.
    • Berikan metadata dokumentasi fungsi.
    • Memiliki handler Test Koneksi ion.
    • Ikuti konvensi penamaan (misalnya, DataSourceKind.FunctionName). Ini tidak boleh menyertakan kata-kata seperti "Power BI", "Koneksi or" atau "API".
    • Atur bendera Beta ke True pada rilis awal.

  • FunctionName harus masuk akal untuk domain (misalnya "Konten", "Tabel", "Dokumen", "Database", dan sebagainya).

  • Konektor HARUS:

    • Memiliki ikon.
    • Sediakan tabel navigasi.
    • Tempatkan string dalam resources.resx file. URL dan nilai harus dikodekan secara permanen dalam kode konektor dan tidak ditempatkan dalam resources.resx file.

Keamanan

Ada pertimbangan keamanan khusus yang harus ditangani konektor Anda.

  • Jika Extension.CurrentCredentials() digunakan:

    • Apakah penggunaan diperlukan? Jika demikian, ke mana kredensial dikirim?
    • Apakah permintaan dijamin dibuat melalui HTTPS?
      • Anda dapat menggunakan fungsi pembantu penegakan HTTPS.
    • Jika kredensial dikirim menggunakan Web.Contents() melalui GET:
      • Dapatkah diubah menjadi POST?
      • Jika GET diperlukan, konektor HARUS menggunakan CredentialQueryString rekaman dalam Web.Contents() rekaman opsi untuk meneruskan kredensial sensitif.

  • Jika Fungsi Diagnostik.* digunakan:

    • Validasi apa yang sedang dilacak; data tidak boleh berisi PII atau sejumlah besar data yang tidak perlu.
    • Jika Anda menerapkan pelacakan signifikan dalam pengembangan, Anda harus menerapkan variabel atau bendera fitur yang menentukan apakah pelacakan harus aktif. Pelacakan ini harus dinonaktifkan sebelum mengirimkan sertifikasi.

  • Jika Expression.Evaluate() digunakan:

    • Validasi dari mana ekspresi berasal dan apa itu (yaitu, dapat membangun panggilan ke Extension.CurrentCredentials() dan sebagainya secara dinamis).
    • tidak Expression boleh disediakan pengguna atau mengambil input pengguna.
    • Expression seharusnya tidak dinamis (yaitu, diambil dari panggilan web).

Mendaftar untuk Sertifikasi

Jika Anda tertarik untuk mengejar sertifikasi konektor kustom Anda, pastikan skenario dan konektor Anda memenuhi prasyarat dan persyaratan yang diuraikan dalam artikel ini. Kegagalan untuk melakukannya akan menyebabkan keterlambatan sertifikasi karena tim kami akan mengharuskan Anda untuk memperbaiki masalah atau inkonsistensi sebelum melanjutkan sertifikasi.

Pastikan konektor Anda selesai kode dan telah diuji dalam penulisan di Power BI Desktop, serta refresh dan konsumsi di Layanan Power BI. Pastikan Anda telah menguji refresh end-to-end penuh di Layanan Power BI melalui penggunaan gateway data lokal.

Untuk memulai, lengkapi formulir pendaftaran kami, dan kontak Microsoft akan menghubungi untuk memulai proses.

Setelah Sertifikasi

Setelah konektor Anda disertifikasi dan dirilis melalui Power BI Desktop dan layanan Power BI, ada beberapa hal yang harus Anda lakukan untuk memastikan Anda dapat menggunakan konektor bersertifikat yang tersedia untuk umum yang disebarkan secara benar.

  • Anda dan pengguna akhir harus menggunakan versi konektor bersertifikat yang disertakan dalam Power BI Desktop, dan gateway data lokal, dan menghapus file .mez atau .pqx yang ada (konektor kustom) yang digunakan sebelum sertifikasi. Kegagalan untuk melakukannya dapat mengakibatkan konektor kustom pengujian Anda digunakan oleh Power Query secara tidak sengaja alih-alih konektor yang baru disertifikasi.
  • Konektor kustom hanya boleh digunakan untuk menguji versi baru konektor.
  • Saat bekerja dengan pengguna akhir dan pelanggan, pastikan bahwa mereka memahami versi konektor kustom yang digunakan dalam pengujian sebelum sertifikasi harus dihapus setelah pengujian selesai dan versi konektor bersertifikat baru tersedia.

Setelah Anda mengembangkan konektor ke sumber data, pertimbangkan untuk membantu pelanggan memulai dan menjalankan dengan cepat dengan membuat aplikasi templat. Aplikasi templat memberi pelanggan laporan bawaan yang terhubung ke data mereka yang dapat mereka gunakan di luar kotak atau menyesuaikan seperlunya.

Catatan

Aplikasi templat tidak mendukung konektor yang memerlukan gateway.