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 è prontoto-go test harness 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 di connettori deve installare l'estensione PowerQuery SDK di Visual Studio Code 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 DataConnectors: Clonare il repository GitHub DataConnectors 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 di confronto PQTest per eseguire i test. Per altri dettagli, vedere Framework di test di Power Query SDK parte 5 - Test del connettore di estensione.
5. Creazione di report e 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.

Gli obiettivi della versione iniziale del framework di test sono:

• Facilità d'uso dell'utilità della riga di comando per consentire agli utenti di 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.
• Prontoto-go set iniziale di test standard da eseguire 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 i 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. Gli sviluppatori di connettori possono quindi concentrarsi sulla creazione della query M per i 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

Parte	section	Dettagli
1	Setup	Configura il tuo ambiente.
2	Preparazione dei dati	Preparazione dei dati di test.
3	Suite 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 del connettore	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.