Información general sobre las pruebas locales de trabajos de Stream Analytics en Visual Studio Code con herramientas de ASA

Puede usar las herramientas de Azure Stream Analytics (herramientas de ASA) para Visual Studio Code a fin de probar los trabajos de Stream Analytics localmente. Al hablar de localidad, hay tres aspectos a tener en cuenta: el contexto de ejecución del trabajo (una máquina local o el servicio en la nube de Azure), los orígenes de entrada y los receptores de salida.

En las ejecuciones locales, la consulta se ejecuta en la máquina local. Para la entrada, los datos se pueden ingerir desde archivos locales u orígenes activos. Los resultados de salida se envían como archivos a una carpeta local o a los receptores activos.

Consideraciones de entrada para ejecuciones locales

En VS Code, se pueden definir entradas locales y activas:

  • Las entradas activas son archivos de configuración que apuntan a una instancia de las entradas admitidas (datos de referencia y de flujo). También ofrecen obtener una vista previa y muestrear los datos en los archivos JSON.
  • Las entradas locales son archivos de configuración que apuntan a un archivo local del formato admitido (JSON/CSV/AVRO). Esos archivos se pueden muestrear desde una entrada activa o generarse de cualquier otra manera.

Al crear una entrada local, se puede alinear con una entrada activa existente. En este caso, simulará la entrada activa durante las ejecuciones de entrada locales. El nombre del archivo de configuración se asignará en función de la entrada activa, precedido de Local_. No se espera que el archivo de datos que utiliza esta entrada local siga el formato de serialización y el formato definidos en la entrada activa. Sus formatos son independientes.

Consideraciones de salida para ejecuciones locales

Al ejecutar un trabajo en salidas locales, los resultados de salida se envían a una carpeta de su proyecto denominada LocalRunOutputs. En este modo, no es necesario definir las salidas. La única restricción es que cada instrucción INTO de la consulta apunta a un nombre de salida único. Después de una ejecución en salidas locales, se creará un archivo JSON para cada nombre de salida único.

Modos de ejecución local

Hay tres modos compatibles con las herramientas de ASA en VS Code para ejecutar trabajos localmente:

  • Ejecución local con entrada local y salida local: perfecta para el desarrollo sin conexión de forma gratuita, pruebas unitarias con el paquete npm
  • Ejecución local con entrada activa y salida local: perfecta para la configuración de entrada, la deserialización y la depuración de particiones...
  • Ejecución local con entrada activa y salida activa: ideal para la configuración de salida, la serialización y la depuración de errores de conversión...

Cada modo admite una configuración de entrada y salida diferente:

Ejecución Modo Entrada Resultados
Código de VS Entrada local a salida local Archivos JSON/CSV/AVRO Archivos JSON (el formato de salida activa correspondiente no se usa aunque exista)
Código de VS Entrada activa a salida local Todos los adaptadores de entrada Archivos JSON (el formato de salida activa correspondiente no se usa aunque exista)
Código de VS Entrada activa a salida activa Todos los adaptadores de entrada Centro de eventos, cuenta de almacenamiento, Azure SQL
Azure N/D Todos los adaptadores de entrada Todos los adaptadores de salida

Al ejecutar trabajos localmente, el servicio Azure Stream Analytics no incurre en ningún costo. No es necesario crear un recurso de Stream Analytics en Azure.

Introducción

Use este inicio rápido para descubrir cómo crear un trabajo de Stream Analytics mediante Visual Studio Code y las herramientas de ASA.

Después, para ver tutoriales paso a paso sobre ejecuciones locales, vea lo siguiente:

Pasos siguientes