Bagikan melalui

Sertifikasi Konektor Data Factory

  • Artikel

Penting

Program sertifikasi konektor saat ini mengalami perubahan dan pendaftaran untuk sertifikasi konektor baru saat ini ditangguhkan. Artikel ini akan diperbarui setelah program sertifikasi konektor terbuka lagi untuk mitra baru. Jika Anda memiliki konektor bersertifikat yang ingin Anda perbarui, hubungi tim dataconnectors@microsoft.com kami untuk mendapatkan petunjuk tentang cara mengirimkan versi baru. Pengiriman diproses setiap bulan dan tanggal cut-off untuk pengiriman adalah Selasa pertama setiap bulan.

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 dengan mendistribusikan konektor yang telah 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.

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.

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).

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.