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, 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 yang siapto-go 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 test harness PQTest.exe. Harness pengujian PQTest berisi perintah bandingkan baru untuk menjalankan pengujian yang ada dalam kerangka kerja pengujian.
2. Kloning Repositori GitHub DataConnectors:Kloning repositori GitHub DataConnectors 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. Konfigurasi dan jalankan pengujian: Pengembang konektor dapat menjalankan pengujian menggunakan Visual Studio Code Test Explorer atau utilitas PowerShell RunPQSDKTestSuites. Untuk informasi selengkapnya tentang opsi ini, lihat Part 5a - Pengujian di Visual Studio Code atau Part 5b - Pengujian dengan PowerShell.
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.

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.
• Siap-to-go set awal pengujian standar yang akan 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. Pengembang konektor 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.

Bagian