Referensi kerangka kerja pengujian Power Query SDK

Referensi multi-bagian ini mencakup penyiapan dan menjalankan rangkaian pengujian standar untuk pengembang konektor Power Query. Referensi dimaksudkan untuk diikuti secara berurutan untuk memastikan bahwa lingkungan Anda disiapkan untuk menguji konektor ekstensi Anda.

Referensi ini menggunakan kerangka kerja pengujian Power Query SDK, rangkaian pengujian standar, dan versi data rekaman perjalanan hijau NewYork City Taxi & Limousine Commission (TLC) yang dimodifikasi. Bagian berikutnya menelusuri langkah-langkah untuk menyiapkan lingkungan Anda untuk memvalidasi konektor ekstensi Anda.

Kerangka kerja pengujian memungkinkan pengembang Power Query SDK memiliki akses ke pengujian standar dan harness pengujian untuk memverifikasi kemampuan DirectQuery (DQ) konektor ekstensi. Dengan kemampuan baru ini, pengembang memiliki cara standar untuk memverifikasi konektor dan platform untuk menambahkan pengujian kustom. Kami membayangkan ini sebagai langkah pertama dalam meningkatkan produktivitas alur kerja pengujian yang disediakan oleh Power Query SDK.

Apa itu kerangka kerja pengujian Power Query SDK?

Kerangka kerja pengujian Power Query SDK adalah harness pengujian siap pakai dengan pengujian bawaan untuk menstandarkan pengujian konektor ekstensi baru dan yang sudah ada. Ini memiliki kemampuan untuk melakukan pengujian fungsional, kepatuhan, dan regresi dalam skala besar. Ini membantu mengatasi kebutuhan kerangka kerja pengujian yang komprehensif untuk memenuhi kebutuhan konektor ekstensi.

Alur kerja untuk pengembang

Daftar berikut ini adalah alur kerja pengembang Power Query SDK umum dengan kerangka kerja pengujian:

1. Instal ekstensi Power Query SDK Visual Studio Code: Pengembang konektor harus menginstal ekstensi PowerQuery SDK Visual Studio Code untuk mengembangkan konektor ekstensi. Ekstensi Visual Studio Code membungkus paket NuGet Microsoft.PowerQuery.SdkTools, yang juga berisi uji harness PQTest.exe. Harness pengujian PQTest berisi perintah bandingkan baru untuk menjalankan pengujian yang ada dalam kerangka kerja pengujian.
2. Mengkloning Repo GitHub Data Koneksi ors: Mengkloning repositori GitHub Data Koneksi ors untuk mengakses data pengujian dan pengujian yang terkandung dalam kerangka kerja pengujian. Untuk detail selengkapnya tentang pengujian ini, buka kerangka kerja pengujian PowerQuery SDK bagian 3 - Rangkaian pengujian.
3. Muat data pengujian ke sumber data: Pengembang konektor harus memuat data pengujian, yang terdiri dari dua file CSV, sebagai tabel ke sumber data mereka, yang memastikan skema cocok dengan file skema SQL yang disediakan. Untuk detail selengkapnya, buka kerangka kerja pengujian Power Query SDK bagian 2 - Uji data.
4. Mengonfigurasi dan menjalankan pengujian: Pengembang konektor harus kemudian menjalankan pengujian menggunakan utilitas PowerShell RunPQSDKTestSuites yang disediakan, yang menggunakan perintah PQTest compare untuk menjalankan pengujian. Untuk detail selengkapnya, buka kerangka kerja pengujian Power Query SDK bagian 5 - Menguji konektor ekstensi Anda.
5. Pelaporan & CI/CD: Laporan pengujian default dihasilkan di konsol dan ada juga opsi untuk menghasilkan laporan dalam format ringkasan, terperinci, TRX, dan JSON. Format TRX (file hasil pengujian Visual Studio) berguna untuk melihat hasilnya saat dijalankan sebagai bagian dari alur. Untuk detail selengkapnya, buka kerangka kerja pengujian Power Query SDK bagian 7 - Panduan alur.

Tujuan kerangka kerja pengujian

Tujuan jangka panjang kerangka kerja pengujian Power Query SDK adalah untuk menyediakan solusi pengujian yang kuat yang terintegrasi dengan Visual Studio Code SDK untuk menguji konektor ekstensi. Ini harus sangat meningkatkan pengalaman pengembang untuk pengembangan konektor. Ini juga harus membawa standardisasi ke praktik pengujian yang agak terfragmentasi, akhirnya meningkatkan bilah kualitas dan mengurangi upaya keberlanjutan konektor. Kami juga membayangkan kerangka kerja pengujian untuk terhubung ke proses sertifikasi konektor dan meningkatkan pengalaman bagi mitra.

Tujuan dari rilis awal kerangka kerja pengujian adalah untuk menyediakan:

• Utilitas baris perintah yang mudah digunakan bagi pengguna untuk menguji konektor ekstensi mereka dengan mudah: Kerangka kerja pengujian memperkenalkan perintah perbandingan PQTest dengan opsi intuitif untuk menjalankan pengujian. Ini juga menyediakan utilitas PowerShell RunPQSDKTestSuites, yang juga membantu pengujian batch. Konfigurasi mudah dan otomatis disediakan untuk mengonfigurasi dan menjalankan pengujian.
• Set awal pengujian standar siap pakai untuk dijalankan untuk memverifikasi konektor: Kerangka kerja pengujian menyediakan serangkaian pengujian kewarasan untuk memvalidasi skema, jumlah baris, dan data tabel pengujian. Ini juga menyediakan rangkaian pengujian standar untuk memverifikasi Datatypes, Matematika, Tanggal, Waktu, Fungsi teks, operator, dan gabungan.
• Cara mudah menambahkan pengujian secara manual untuk memperluas pengujian: Pengujian dalam kerangka kerja pengujian menggunakan format pengujian PQ/PQOut baru, yang menyederhanakan proses pembuatan pengujian dengan meminimalkan konfigurasi yang diperlukan. Koneksi or pengembang kemudian dapat fokus pada pembuatan kueri M untuk pengujian mereka. Setiap pengujian bersifat modular dan dipisahkan menjadi file individual untuk menyederhanakan pemeliharaan. Output yang diharapkan juga dihasilkan dalam eksekusi pertama.
• Kemampuan untuk menguji pengujian lipatan kueri: Kerangka kerja pengujian juga dapat menghasilkan diagnostik untuk konektor. Saat ini, kemampuan diagnostik terbatas pada pembuatan kueri SQL selama pelipatan kueri untuk konektor berbasis ODBC. Kemampuan ini akan diperluas ke diagnostik lain di masa depan.

Gambaran umum panduan referensi

Dalam panduan ini, Anda:

• Dapatkan pemahaman tentang kerangka kerja pengujian Power Query SDK.
• Pelajari cara menyiapkan lingkungan pengembangan dengan menginstal kerangka kerja pengujian.
• Ambil himpunan data yang digunakan dalam rangkaian pengujian dan unggah ke sumber data berdasarkan konektor ekstensi Anda.
• Pahami spesifikasi format pengujian yaitu, format file dan fungsionalitasnya dalam Kerangka Kerja Pengujian.
• Ambil dan jalankan rangkaian pengujian yang berisi pengujian untuk memvalidasi konektor ekstensi Anda.
• Jalankan pengujian individual dengan konfigurasi yang berbeda.
• Tambahkan pengujian Anda sendiri untuk memverifikasi fungsionalitas khusus konektor Anda.
• Mengotomatiskan eksekusi pengujian dengan menyiapkan alur untuk pengujian.

Generator

Bagian	bagian	Detail
1	Siapkan	Siapkan lingkungan Anda.
2	Menyiapkan data	Menyiapkan data pengujian.
3	Rangkaian pengujian	Mengambil dan memahami rangkaian pengujian.
4	Spesifikasi format pengujian	Memahami berbagai format file yang digunakan dalam kerangka kerja pengujian.
5	pengujian Koneksi or	Menguji konektor ekstensi Anda.
6	Menambahkan pengujian	Menambahkan pengujian Anda sendiri dan memahami berbagai opsi dan konfigurasi dalam kerangka kerja pengujian.
7	Panduan penyiapan alur	Menjalankan pengujian dalam alur.