Sviluppa lavori Stream Analytics Edge utilizzando strumenti Visual Studio

In questo articolo viene illustrato come usare gli strumenti di Stream Analytics per Visual Studio per scrivere, eseguire il debug e creare processi di Stream Analytics Edge. Dopo aver creato e testato il lavoro, vai al portale Azure per distribuirlo sui tuoi dispositivi.

Prerequisiti per sviluppare lavori Edge

Sono necessari i seguenti prerequisiti per completare i passaggi di questo articolo:

  1. Installa Visual Studio 2019, Visual Studio 2015 o Visual Studio 2013 Aggiornamento 4. Gli strumenti di Stream Analytics supportano le edizioni Enterprise (Ultimate/Premium), Professional e Community, ma non l'edizione Express.

  2. Seguire le istruzioni di installazione per installare gli strumenti di Analisi di flusso per Visual Studio.

Crea un progetto Edge di Stream Analytics

Crea il progetto Edge che contiene la definizione del tuo lavoro.

  1. In Visual Studio, seleziona File>Nuovo>Progetto. Vai all'elenco Modelli a sinistra, quindi espandi Analisi di flusso di Azure>Stream Analytics Edge>Analisi di flusso di Azure Edge Application. Inserisci un nome, una posizione e un nome della soluzione per il tuo progetto, poi seleziona OK.

    Screenshot della finestra di dialogo New Project per creare un'applicazione Analisi di flusso di Azure Edge in Visual Studio.

  2. Dopo che Visual Studio crea il progetto, vai su Esplora soluzioni per visualizzare la gerarchia delle cartelle.

    Screenshot di Esplora soluzioni che mostra la gerarchia delle cartelle di un progetto Stream Analytics Edge in Visual Studio.

Scegli l'abbonamento corretto

Collega Visual Studio all'abbonamento Azure dove vuoi creare il lavoro.

  1. Dal menu Vista Visual Studio, seleziona Server Explorer.

  2. Seleziona e tieni premuto (o clicca destro) Azure, seleziona Collegati a Microsoft Azure Subscription, e poi accedi con il tuo account Azure.

Definire gli ingressi

Configura l'ingresso di Edge Hub da cui il processo legge gli eventi di streaming.

  1. Dal Esplora soluzioni, espandi il nodo Inputs. Vedi un input chiamatoEdgeInput.json. Apri per visualizzarne le impostazioni.

  2. Imposta il tipo di origine su Flusso di dati. Poi imposta la sorgente su edge hub, il formato di serializzazione degli eventi su JSON e la codifica su UTF8. Opzionalmente, rinomina l'Alias di Input, ma lascialo com'è per questo esempio. Se rinomini l'alias di input, usa il nome che specifichi quando definisci la query. Selezionare Salva per salvare le impostazioni. Schermata delle impostazioni di configurazione dell'input di Stream Analytics Edge Hub in Visual Studio.

Definire gli output

Configura l'output dell'Edge Hub su cui il lavoro scrive i risultati.

  1. Dal Esplora soluzioni, espandi il nodo Outputs. Vedi un output chiamatoEdgeOutput.json. Aprilo per visualizzare le sue impostazioni.

  2. Imposta Sink su Edge Hub, imposta Formato di serializzazione degli eventi su Json, imposta Codifica su UTF8 e imposta Formato su Array. Opzionalmente, rinomina l'Alias di Output, ma lascialo com'è per questo esempio. Se rinomini l'alias di output, usa il nome che specifichi quando definisci la query. Selezionare Salva per salvare le impostazioni. Schermata delle impostazioni di configurazione dell'output di Stream Analytics Edge Hub in Visual Studio.

Rivedere le operazioni non supportate

I lavori di Stream Analytics implementati negli ambienti Stream Analytics IoT Edge supportano la maggior parte del riferimento al linguaggio di query di Stream Analytics. Tuttavia, le seguenti operazioni non sono supportate per i lavori Edge di Stream Analytics:

  1. PARTIZIONE PER
  2. MARCA TEMPORALE PER SOVRAPPOSIZIONE
  3. Funzione definita dall'utente JavaScript (UDF)
  4. Aggregati definiti dall'utente (UDA)
  5. GetMetadataPropertyValue
  6. Utilizzando più di 14 aggregati in un unico passaggio

Quando crei un job Stream Analytics Edge nel portale, il compilatore ti avvisa automaticamente se non stai usando un operatore supportato.

Definire la query di trasformazione

Da Visual Studio, definisci la seguente query di trasformazione nell'editor di query (il script.asaql file).

SELECT * INTO EdgeOutput
FROM EdgeInput

Testa il lavoro localmente

Per testare localmente la query, carica i dati campione. Per ottenere dati di esempio, scarica i dati di registrazione dal repository GitHub e salvali sul tuo computer locale.

  1. Per caricare i dati di campione, seleziona e tieni premuto (o clicca con il tasto destro) il file EdgeInput.json , poi seleziona Aggiungi input locale.

  2. Nella finestra pop-up, sfoglia i dati campioni del percorso locale e seleziona Salva.

    Screenshot della configurazione locale di input per il caricamento dei dati di esempio in Visual Studio.

  3. Visual Studio aggiunge automaticamente un file chiamatolocal_EdgeInput.json alla cartella degli input.

  4. Puoi farlo girare localmente o inviarlo ad Azure. Per testare la query, seleziona Esegui localmente.

    Screenshot delle opzioni di esecuzione del lavoro di Stream Analytics che mostrano Esegui localmente in Visual Studio.

  5. La finestra del prompt dei comandi mostra lo stato del lavoro. Quando il lavoro viene eseguito con successo, crea una cartella che appare come 2018-02-23-11-31-42 nel percorso Visual Studio 2015\Projects\MyASAEdgejob\MyASAEdgejob\ASALocalRun\2018-02-23-11-31-42della cartella del progetto. Vai al percorso della cartella per visualizzare i risultati nella cartella locale.

    Puoi anche accedere al portale Azure e verificare che il lavoro sia stato creato.

    Schermata della cartella dei risultati del processo Stream Analytics che mostra l'output dell'esecuzione locale in Visual Studio.

Invia il lavoro ad Azure

Dopo aver testato la query, pubblica il lavoro sul tuo abbonamento Azure.

  1. Prima di inviare il lavoro ad Azure, collegati al tuo abbonamento Azure. Apri Server Explorer, seleziona e tieni premuto (o clicca destro) Azure, seleziona Collegati a Microsoft Azure e poi accedi al tuo abbonamento Azure.

  2. Per inviare il lavoro ad Azure, vai nell'editor delle query e seleziona Invia ad Azure.

  3. Verrà visualizzata una finestra popup. Scegli di aggiornare un lavoro Stream Analytics Edge esistente o crearne uno nuovo. Quando aggiorni un lavoro esistente, sostituisce tutta la configurazione del lavoro. In questo scenario, pubblichi un nuovo lavoro. Seleziona Crea un nuovo lavoro Analisi di flusso di Azure, inserisci un nome per il tuo lavoro come MyASAEdgeJob, scegli l'abbonamento richiesto, il gruppo risorse e la località, e poi seleziona Invia.

    Screenshot della finestra di dialogo per inviare un lavoro Stream Analytics Edge ad Azure da Visual Studio.

    Ora hai un lavoro Stream Analytics Edge. Per imparare come distribuirlo sui tuoi dispositivi, consulta Run jobs su IoT Edge.

Gestire il lavoro

Gestisci lo stato del lavoro e il diagramma del lavoro da Server Explorer.

  1. Da Stream Analytics in Server Explorer, espandi l'abbonamento e il gruppo di risorse dove hai distribuito il lavoro Stream Analytics Edge. Vedi MyASAEdgejob con lo stato Creato. Espandi il nodo del tuo lavoro, poi aprilo per visualizzare il lavoro.

    Schermata di Server Explorer che mostra le opzioni di gestione dei processi per un processo di Stream Analytics Edge.

  2. Nella finestra della vista del lavoro, puoi aggiornare il lavoro, eliminarlo e aprirlo nel portale Azure.

    Screenshot della finestra della vista del lavoro che mostra il diagramma del lavoro e altre opzioni in Visual Studio.

Contenuti correlati

  • Last updated on