Overzicht van lokaal testen van Stream Analytics-taken in Visual Studio Code met ASA Tools
U kunt Azure Stream Analytics Tools (ASA Tools) voor Visual Studio Code gebruiken om uw Stream Analytics-taken lokaal te testen. Als u het over lokaliteit hebt, moet u rekening houden met drie aspecten: de taakuitvoeringscontext (een lokale machine of de Azure-cloudservice), de invoerbronnen en de uitvoersinks.
In lokale uitvoeringen wordt de query uitgevoerd op de lokale computer. Voor invoer kunnen gegevens worden opgenomen uit lokale bestanden of livebronnen. Uitvoerresultaten worden als bestanden verzonden naar een lokale map of naar de live sinks.
Invoeroverwegingen voor lokale uitvoeringen
In VS Code kunt u live en lokale invoer definiëren:
- Live-invoer is configuratiebestanden die verwijzen naar een exemplaar van de ondersteunde invoer (stream- en referentiegegevens). Ze bieden ook een voorbeeld van en voorbeelden van gegevens in JSON-bestanden.
- Lokale invoer is configuratiebestanden die verwijzen naar een lokaal bestand met de ondersteunde indeling (JSON/CSV/AVRO). Deze bestanden kunnen worden bemonsterd op basis van live-invoer of op een andere manier worden gegenereerd.
Wanneer u een lokale invoer maakt, kan deze worden uitgelijnd op een bestaande live-invoer. In dit geval wordt de live-invoer gesimuleerd tijdens lokale invoeruitvoeringen. Het configuratiebestand krijgt de naam van de live-invoer, voorafgegaan door Local_. Het gegevensbestand dat door deze lokale invoer wordt gebruikt, volgt naar verwachting niet de indeling en serialisatie-indeling die zijn gedefinieerd in de live-invoer. Hun indelingen zijn onafhankelijk.
Uitvoeroverwegingen voor lokale uitvoeringen
Wanneer u een taak uitvoert voor lokale uitvoer, worden de uitvoerresultaten verzonden naar een map in uw project met de naam LocalRunOutputs. In deze modus hoeven uitvoerwaarden niet te worden gedefinieerd. De enige beperking is dat elke INTO instructie in de query verwijst naar een unieke uitvoernaam. Na een uitvoering van de lokale uitvoer wordt er een JSON-bestand gemaakt voor elke unieke uitvoernaam.
Lokale uitvoeringsmodi
Er worden drie modi ondersteund door ASA Tools in VS Code om taken lokaal uit te voeren:
- Lokale uitvoering met lokale invoer en lokale uitvoer: het beste voor gratis offlineontwikkeling, eenheidstests met het npm-pakket...
- Lokale uitvoering met live-invoer en lokale uitvoer: het beste voor invoerconfiguratie, deserialisatie en foutopsporing voor partitionering...
- Lokale uitvoering met live-invoer en live-uitvoer: het meest geschikt voor foutopsporing van uitvoerconfiguratie, serialisatie en conversie...
Elke modus ondersteunt verschillende invoer- en uitvoerconfiguratie:
| Uitvoering | Modus | Invoer | Uitvoer |
|---|---|---|---|
| VS-code | Lokale invoer naar lokale uitvoer | JSON-/CSV-/AVRO-bestanden | JSON-bestanden (de bijbehorende indeling voor live-uitvoer wordt niet gebruikt, zelfs niet als deze bestaat) |
| VS-code | Live-invoer naar lokale uitvoer | Alle invoeradapters | JSON-bestanden (de bijbehorende indeling voor live-uitvoer wordt niet gebruikt, zelfs niet als deze bestaat) |
| VS-code | Live-invoer naar live-uitvoer | Alle invoeradapters | Event Hub, Opslagaccount, Azure SQL |
| Azure | N.v.t. | Alle invoeradapters | Alle uitvoeradapters |
Wanneer u taken lokaal uitvoert, worden er geen kosten gemaakt voor de Azure Stream Analytics-service. Het is niet nodig om een Stream Analytics-resource te maken in Azure.
Aan de slag
Gebruik deze quickstart voor meer informatie over het maken van een Stream Analytics-taak met behulp van Visual Studio Code en ASA Tools.
Zie vervolgens voor stapsgewijze zelfstudies over lokale uitvoeringen:
- Stream Analytics-query's lokaal testen met voorbeeldgegevens testen met behulp van Visual Studio Code
- Stream Analytics-query's lokaal testen op basis van livestream-invoer met behulp van Visual Studio Code