Partager via

Vue d’ensemble des tests locaux de travaux Stream Analytics dans Visual Studio Code avec ASA Tools

  • Article

Vous pouvez utiliser Azure Stream Analytics Tools (ASA Tools) pour Visual Studio Code afin de tester vos travaux Stream Analytics localement. En ce qui concerne la localité, il y a trois aspects à prendre en compte : le contexte d’exécution du travail (ordinateur local ou service cloud Azure), les sources d’entrée et les récepteurs de sortie.

Dans des exécutions locales, la requête est exécutée sur l’ordinateur local. Pour l’entrée, les données peuvent être ingérées à partir de fichiers locaux ou de sources en direct. Les résultats de sortie sont envoyés en tant que fichiers à un dossier local ou aux récepteurs en direct.

Considérations relatives à l’entrée pour les exécutions locales

Dans VS Code, vous pouvez définir des entrées en direct et locales :

  • Les entrées en direct sont des fichiers de configuration pointant vers une instance des entrées prises en charge (flux et données de référence). Ils permettent également de prévisualiser et d’échantillonner des données dans des fichiers JSON.
  • Les entrées locales sont des fichiers de configuration pointant vers un fichier local au format pris en charge (JSON/CSV/AVRO). Ces fichiers peuvent être échantillonnés à partir d’une entrée en direct, ou générés d’une autre façon.

Lors de la création d’une entrée locale, il est possible de l’aligner sur une entrée en direct existante. Dans ce cas, l’entrée locale simule l’entrée en direct pendant l’exécution de l’entrée locale. Son fichier de configuration est nommé d’après l’entrée en direct, avec le préfixe Local_. Le fichier de données utilisé par cette entrée locale n’est pas censé suivre le format et le format de sérialisation définis dans l’entrée en direct. Leurs formats sont indépendants.

Considérations relatives à la sortie pour les exécutions locales

Lors de l’exécution d’un travail sur des sorties locales, les résultats sont envoyés à un dossier dans votre projet, nommé LocalRunOutputs. Dans ce mode, il n’est pas nécessaire de définir des sorties. La seule contrainte est que chaque instruction INTO dans la requête pointe vers un nom de sortie unique. Après une exécution vers une sortie locale, un fichier JSON est créé pour chaque nom de sortie unique.

Modes d’exécution locaux

ASA Tools dans VS Code prend en charge trois modes pour l’exécution de travaux localement :

  • Exécution locale avec entrée et sortie locales : idéale pour le développement hors connexion sans coût, tests unitaires avec le package npm…
  • Exécution locale avec entrée en direct et sortie locale : idéale pour le débogage de configuration d’entrée, de désérialisation et de partitionnement…
  • Exécution locale avec entrée et sortie en direct : idéale pour le débogage d’erreurs de configuration de sortie, de sérialisation et de conversion…

Chaque mode prend en charge différentes configurations d’entrée et de sortie :

Exécution Mode Entrée Output
VS Code Entrée locale vers sortie locale Fichiers JSON/CSV/AVRO Fichiers JSON (le format de sortie en direct correspondant n’est pas utilisé, même s’il existe)
VS Code Entrée en direct vers sortie locale Tous les adaptateurs d’entrée Fichiers JSON (le format de sortie en direct correspondant n’est pas utilisé, même s’il existe)
VS Code Entrée en direct vers sortie en direct Tous les adaptateurs d’entrée Event Hub, Compte de stockage, Azure SQL
Azure N/A Tous les adaptateurs d’entrée Tous les adaptateurs de sortie

Lors de l’exécution de travaux localement, aucun le service Azure Stream Analytics n’occasionne aucun coût. Il n’est pas nécessaire de créer une ressource Stream Analytics dans Azure.

Prise en main

Utilisez ce démarrage rapide pour apprendre à créer un travail Stream Analytics à l’aide de Visual Studio Code et d’ASA Tools.

Pour obtenir des didacticiels pas à pas sur les exécutions locales, consultez :

Étapes suivantes