Informazioni di riferimento sul framework di test di Power Query SDK

Questo riferimento in più parti illustra la configurazione e l'esecuzione di una suite standard di test per gli sviluppatori di connettori di Power Query. Il riferimento deve essere seguito in sequenza per assicurarsi che l'ambiente sia configurato per il test del connettore di estensione.

Questo riferimento usa il framework di test di Power Query SDK, un gruppo di test standardizzato e una versione modificata dei dati dei record di viaggio verdi newYork City Taxi & Limousine Commission (TLC). Le sezioni successive illustrano i passaggi per configurare l'ambiente per convalidare il connettore di estensione.

Il framework di test consente agli sviluppatori di Power Query SDK di accedere ai test standard e a un test harness per verificare le funzionalità DirectQuery (DQ) di un connettore di estensione. Con questa nuova funzionalità, gli sviluppatori hanno un modo standard per verificare i connettori e una piattaforma per l'aggiunta di test personalizzati. Questo è il primo passaggio per migliorare la produttività del flusso di lavoro di test fornito da Power Query SDK.

Che cos'è il framework di test di Power Query SDK?

Il framework di test di Power Query SDK è un test harness pronto per l'uso con test predefiniti per standardizzare i test dei connettori di estensione nuovi ed esistenti. Ha la possibilità di eseguire test funzionali, di conformità e di regressione su larga scala. Consente di soddisfare la necessità di un framework di test completo per soddisfare le esigenze dei connettori di estensione.

Flusso di lavoro per uno sviluppatore

L'elenco seguente è il tipico flusso di lavoro per sviluppatori di Power Query SDK con il framework di test:

1. Installare l'estensione Di Visual Studio Code di Power Query SDK: uno sviluppatore del connettore deve installare l'estensione Di Visual Studio Code di PowerQuery SDK per lo sviluppo di un connettore di estensione. L'estensione Visual Studio Code esegue il wrapping del pacchetto NuGet Microsoft.PowerQuery.SdkTools, che contiene anche test harness PQTest.exe. Il test harness PQTest contiene il nuovo comando di confronto per eseguire i test presenti nel framework di test.
2. Clonare il repository GitHub Data Connessione ors: clonare il repository GitHub Data Connessione ors per accedere ai dati di test e ai test contenuti nel framework di test. Per altri dettagli su questi test, vedere Framework di test di PowerQuery SDK parte 3 - Gruppo di test.
3. Caricare i dati di test nell'origine dati: lo sviluppatore del connettore deve caricare i dati di test, costituiti da due file CSV, come tabelle nell'origine dati, che garantisce che lo schema corrisponda al file di schema SQL fornito. Per altri dettagli, vedere Framework di test di Power Query SDK parte 2 - Dati di test.
4. Configurare ed eseguire i test: lo sviluppatore del connettore deve quindi eseguire i test usando l'utilità PowerShell RunPQSDKTestSuites fornita, che usa il comando PQTest compare per eseguire i test. Per altri dettagli, vedere Framework di test di Power Query SDK parte 5 - Test del connettore di estensione.
5. Reporting & CI/CD: il report di test predefinito viene generato nella console e sono disponibili anche opzioni per generare il report in formato riepilogo, dettagliato, TRX e JSON. Il formato TRX (file dei risultati dei test di Visual Studio) è utile per visualizzare i risultati quando vengono eseguiti come parte di una pipeline. Per altri dettagli, vedere La guida al framework di test di Power Query SDK parte 7 - Guida alla pipeline.

Obiettivi del framework di test

L'obiettivo a lungo termine del framework di test di Power Query SDK è fornire una soluzione di test affidabile integrata con Visual Studio Code SDK per testare i connettori di estensione. Dovrebbe migliorare notevolmente l'esperienza di sviluppo per lo sviluppo dei connettori. Dovrebbe anche portare la standardizzazione a procedure di test piuttosto frammentate, aumentando infine la barra di qualità e riducendo gli sforzi di sostegno dei connettori. Si prevede anche il framework di test per collegare il processo di certificazione del connettore e migliorare l'esperienza per i partner.

Gli obiettivi della versione iniziale del framework di test sono:

• Facile da usare l'utilità della riga di comando per gli utenti per testare facilmente i connettori di estensione: il framework di test introduce il comando PQTest compare con opzioni intuitive per eseguire i test. Fornisce anche l'utilità PowerShell RunPQSDKTestSuites, che consente anche di eseguire il test in batch. Sono disponibili configurazioni semplici e automatiche per configurare ed eseguire i test.
• Set iniziale pronto per l'esecuzione di test standard per verificare un connettore: il framework di test fornisce un gruppo di test di integrità per convalidare lo schema, il numero di righe e i dati delle tabelle di test. Fornisce anche un gruppo di test standard per verificare tipi di dati, matematica, data, ora, funzioni di testo, operatori e join.
• Modo semplice per aggiungere manualmente i test per estendere il test: i test nel framework di test usano il nuovo formato di test PQ/PQOut, che semplifica il processo di creazione dei test riducendo al minimo le configurazioni necessarie. Connessione or gli sviluppatori possono quindi concentrarsi sulla creazione della query M per il test. Ogni test è modulare e separato in singoli file per semplificare la manutenzione. L'output previsto viene generato anche nella prima esecuzione.
• Possibilità di testare i test di riduzione delle query: il framework di test può anche generare la diagnostica per un connettore. Attualmente, la funzionalità di diagnostica è limitata alla generazione di query SQL durante la riduzione delle query per un connettore basato su ODBC. Questa funzionalità verrà estesa ad altre diagnostica in futuro.

Panoramica della guida di riferimento

In questa guida:

• Acquisire informazioni sul framework di test di Power Query SDK.
• Informazioni su come configurare l'ambiente di sviluppo installando il framework di test.
• Recuperare il set di dati usato nel gruppo di test e caricarlo in un'origine dati in base al connettore di estensione.
• Comprendere le specifiche del formato di test, i formati di file e le relative funzionalità all'interno del framework di test.
• Recuperare ed eseguire il gruppo di test che contiene i test per la convalida del connettore di estensione.
• Eseguire singoli test con configurazioni diverse.
• Aggiungere test personalizzati per verificare la funzionalità specifica del connettore.
• Automatizzare le esecuzioni dei test configurando una pipeline per i test.

Parti

In parte	section	Dettagli
1	Impostazioni	Configurare l'ambiente.
2	Preparazione dei dati	Preparazione dei dati di test.
3	Gruppo di test	Recupero e comprensione del gruppo di test.
4	Specifica di formato di test	Informazioni sui vari formati di file usati nel framework di test.
5	test di Connessione or	Test del connettore di estensione.
6	Aggiunta di test	Aggiunta di test personalizzati e comprensione di varie opzioni e configurazioni nel framework di test.
7	Guida alla configurazione della pipeline	Esecuzione dei test in una pipeline.