Bagikan melalui

Sertifikasi Konektor Data Factory

  • Artikel

Catatan

Artikel ini menjelaskan persyaratan dan proses untuk mengirimkan konektor Data Factory untuk sertifikasi. Baca seluruh artikel secara dekat sebelum memulai proses sertifikasi.

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

Mensertifikasi konektor Data Factory membuat konektor tersedia secara publik, siap pakai, Microsoft Fabric Data Factory, dan Microsoft Power BI dalam pengalaman berikut:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Model semantik Microsoft Power BI (di Layanan Power BI)
  • Microsoft Power BI Desktop
  • Gateway data lokal untuk Microsoft Fabric dan Microsoft Power BI

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 diarahkan ke pengembang mitra.

Catatan

Hari ini Anda dapat memanfaatkan Power Query SDK untuk membuat konektor yang dapat disertifikasi melalui program sertifikasi konektor Data Factory. Buka gambaran umum Power Query SDK untuk mempelajari selengkapnya tentang alat ini.

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. Microsoft tidak menawarkan bantuan teknis atau konsultasi pengembangan konektor kustom. Sebaiknya gunakan 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. 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. Untuk mempelajari lebih lanjut, hubungi kontak sertifikasi Microsoft Anda.

  • Pengembang harus memberikan perkiraan untuk penggunaan saat ini dan di masa mendatang.

  • 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 selesai langsung ke pengguna akhir dan organisasi. Kami menyarankan agar pengembang konektor menggunakan mekanisme distribusi mandiri dan menjalankan pengujian internal konektor mereka sendiri untuk melakukan iterasi melalui konektor mereka di bawah grup terkontrol. 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 Fabric Ideas yang didorong oleh pelanggan untuk menunjukkan permintaan untuk membuat konektor tersedia untuk umum di Data Factory dan / atau Power BI. 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 mengenai peninjauan dan persetujuan konektor apa pun. Tenggat waktu keras 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 awal 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.

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 berikut disertakan dalam pengiriman Anda:

  • File konektor (.mez)

    • File .mez harus mengikuti standar gaya dan diberi nama yang mirip dengan nama produk atau layanan. Ini tidak boleh menyertakan kata-kata seperti "Fabric", "Power BI", "Connector", 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 mungkin 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 TestConnection.
    • Ikuti konvensi penamaan (misalnya, DataSourceKind.FunctionName). Ini tidak boleh menyertakan kata-kata seperti "Fabric", "Power BI", "Connector", atau "API".
    • Mengembalikan data dalam format tabular, disusun ke dalam tabel dengan kolom, seperti untuk sumber data relasional. Format multidireksional berdasarkan kubus, dimensi, dan pengukuran tidak didukung.
    • Bertingkah sama dalam mode Impor dan DirectQuery, mengembalikan hasil yang identik.
    • 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 secara dinamis ke Extension.CurrentCredentials(), dan sebagainya).
    • Yang Expression seharusnya tidak 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 mengharuskan Anda untuk memperbaiki masalah atau inkonsistensi apa pun sebelum melanjutkan sertifikasi.

Pastikan konektor Anda selesai kode dan telah diuji dalam penulisan di Power BI Desktop, serta refresh dan konsumsi dalam layanan Power BI. Pastikan Anda telah menguji refresh end-to-end penuh di Layanan Power BI dengan menggunakan 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 pengalaman Microsoft Fabric dan Microsoft 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 lingkungan sebelum sertifikasi (seperti Power BI Desktop dan Data Gateway) 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.