Descrição geral dos testes locais das tarefas do Stream Analytics no Visual Studio Code com as Ferramentas do ASA
Pode utilizar as Ferramentas do Azure Stream Analytics (ASA Tools) para Visual Studio Code para testar localmente as tarefas do Stream Analytics. Ao falar de localidade, existem três aspetos a considerar: o contexto de execução da tarefa (um computador local ou o serviço cloud do Azure), as origens de entrada e os sinks de saída.
Em execuções locais, a consulta é executada no computador local. Para entrada, os dados podem ser ingeridos a partir de ficheiros locais ou origens dinâmicas. Os resultados de saída são enviados como ficheiros para uma pasta local ou para os sinks dinâmicos.
Considerações de entrada para execuções locais
No VS Code, pode definir entradas em direto e locais:
- As entradas em direto são ficheiros de configuração que apontam para uma instância das entradas suportadas (dados de transmissão em fluxo e de referência). Também oferecem para pré-visualizar e amostrar dados para ficheiros JSON.
- As entradas locais são ficheiros de configuração que apontam para um ficheiro local do formato suportado (JSON/CSV/AVRO). Esses ficheiros podem ser amostrados a partir de uma entrada dinâmica ou gerados de qualquer outra forma.
Ao criar uma entrada local, pode ser alinhada com uma entrada dinâmica existente. Neste caso, irá gozar com a entrada dinâmica durante as execuções de entradas locais. O respetivo ficheiro de configuração terá o nome da entrada em direto, com o prefixo .Local_ Não se espera que o ficheiro de dados utilizado por esta entrada local siga o formato e o formato de serialização definidos na entrada dinâmica. Os respetivos formatos são independentes.
Considerações de saída para execuções locais
Ao executar uma tarefa para saídas locais, os resultados de saída são enviados para uma pasta no projeto denominada LocalRunOutputs. Neste modo, as saídas não precisam de ser definidas. A única restrição é que cada INTO instrução na consulta aponta para um nome de saída exclusivo. Após uma execução para saídas locais, será criado um ficheiro JSON para cada nome de saída exclusivo.
Modos de execução locais
Existem três modos suportados pelas Ferramentas do ASA no VS Code para executar tarefas localmente:
- Execução local com entrada local e saída local: melhor para desenvolvimento offline sem custos, teste de unidades com o pacote npm...
- Execução local com entrada em direto e saída local: melhor para configuração de entrada, des serialização e depuração de partições...
- Execução local com entrada em direto e saída em direto: melhor para a configuração de saída, serialização e depuração de erros de conversão...
Cada modo suporta diferentes configurações de entrada e saída:
| Execução | Modo | Input | Saída |
|---|---|---|---|
| Código VS | Entrada local para saída local | Ficheiros JSON/CSV/AVRO | Ficheiros JSON (o formato de saída dinâmico correspondente não é utilizado mesmo que exista) |
| Código VS | Entrada em direto para a saída local | Todos os adaptadores de entrada | Ficheiros JSON (o formato de saída dinâmico correspondente não é utilizado mesmo que exista) |
| Código VS | Entrada em direto para saída em direto | Todos os adaptadores de entrada | Hub de Eventos, Conta de Armazenamento, SQL do Azure |
| Azure | N/D | Todos os adaptadores de entrada | Todos os adaptadores de saída |
Ao executar tarefas localmente, não são incorridos custos a partir do serviço Azure Stream Analytics. Não é necessário criar um recurso do Stream Analytics no Azure.
Introdução
Utilize este início rápido para saber como criar uma tarefa do Stream Analytics com o Visual Studio Code e as Ferramentas do ASA.
Em seguida, para obter tutoriais passo a passo sobre execuções locais, consulte:
- Testar consultas do Stream Analytics localmente com dados de exemplo com o Visual Studio Code
- Testar consultas do Stream Analytics localmente em relação à entrada em fluxo em direto com o Visual Studio Code