Panoramica dei test locali dei processi di Analisi di flusso in Visual Studio Code con ASA Tools
È possibile usare Strumenti di Analisi di flusso di Azure (STRUMENTI ASA) per Visual Studio Code per testare i processi di Analisi di flusso in locale. Quando si parla di località, è necessario considerare tre aspetti: il contesto di esecuzione del processo (un computer locale o il servizio cloud di Azure), le origini di input e i sink di output.
Nelle esecuzioni locali la query viene eseguita nel computer locale. Per l'input, i dati possono essere inseriti da file locali o origini attive. I risultati di output vengono inviati come file a una cartella locale o ai sink live.
Considerazioni sull'input per le esecuzioni locali
In VS Code è possibile definire input live e locali:
- Gli input in tempo reale sono file di configurazione che puntano a un'istanza degli input supportati (flussi e dati di riferimento). Offrono anche l'anteprima e i dati di esempio nei file JSON.
- Gli input locali sono file di configurazione che puntano a un file locale del formato supportato (JSON/CSV/AVRO). Questi file possono essere campionati da un input attivo o generati in qualsiasi altro modo.
Quando si crea un input locale, può essere allineato a un input attivo esistente. In questo caso, verrà simulato l'input in tempo reale durante le esecuzioni dell'input locale. Il file di configurazione verrà denominato dopo l'input attivo, preceduto da Local_. Il file di dati usato da questo input locale non deve seguire il formato di formattazione e serializzazione definito nell'input attivo. I formati sono indipendenti.
Considerazioni sull'output per le esecuzioni locali
Quando si esegue un processo negli output locali, i risultati di output vengono inviati a una cartella nel progetto denominato LocalRunOutputs. In questa modalità non è necessario definire gli output. L'unico vincolo è che ogni INTO istruzione della query punta a un nome di output univoco. Dopo un'esecuzione in output locali, verrà creato un file JSON per ogni nome di output univoco.
Modalità di esecuzione locale
Esistono tre modalità supportate da ASA Tools in VS Code per eseguire processi in locale:
- Esecuzione locale con input locale e output locale: ideale per lo sviluppo offline senza costi, unit test con il pacchetto npm...
- Esecuzione locale con input attivo e output locale: ideale per la configurazione di input, la de-serializzazione e il debug del partizionamento...
- Esecuzione locale con input attivo e output live: ideale per la configurazione dell'output, la serializzazione e il debug degli errori di conversione...
Ogni modalità supporta una configurazione di input e output diversa:
| Esecuzione | Modalità | Input | Output |
|---|---|---|---|
| Visual Studio Code | Input locale nell'output locale | File JSON/CSV/AVRO | File JSON (il formato di output live corrispondente non viene usato anche se esistente) |
| Visual Studio Code | Input in tempo reale nell'output locale | Tutti gli adattatori di input | File JSON (il formato di output live corrispondente non viene usato anche se esistente) |
| Visual Studio Code | Input in tempo reale nell'output live | Tutti gli adattatori di input | Hub eventi, account di archiviazione, Azure SQL |
| Azure | N/D | Tutti gli adattatori di input | Tutti gli adattatori di output |
Quando si eseguono processi in locale, non vengono addebitati costi dal servizio Analisi di flusso di Azure. Non è necessario creare una risorsa di Analisi di flusso in Azure.
Introduzione
Usare questa guida introduttiva per informazioni su come creare un processo di Analisi di flusso usando Visual Studio Code e ASA Tools.
Per le esercitazioni dettagliate sulle esecuzioni locali, vedere:
- Eseguire test locali delle query di Analisi di flusso con dati di esempio con Visual Studio Code
- Testare le query di Analisi di flusso in locale sull'input del flusso live usando Visual Studio Code