Condividi tramite

Come eseguire la migrazione di progetti ASA in Visual Studio Code

Questo articolo fornisce indicazioni per gli utenti di Visual Studio che eseguono la migrazione di progetti di Analisi di flusso di Azure (ASA) a Visual Studio Code (VS Code). Si noti che l'estensione ASA Tools per Visual Studio non è più gestita. È consigliabile usare l'estensione asa tools in VS Code per i test locali prima di inviare e avviare un processo ASA.

Se si ha un progetto ASA locale in Visual Studio, seguire questa procedura per inviare il progetto ASA al portale di Azure.

Installare l'estensione VS Code e ASA Tools

  1. Installare Visual Studio Code

  2. Aprire Visual Studio Code, selezionare Estensioni nel riquadro sinistro, cercare Analisi di flusso e selezionare Installa nell'estensione Strumenti di Analisi di flusso di Azure.

    Cercare Analisi di flusso

  3. Dopo aver installato l'estensione, verificare che Strumenti di Analisi dei dati di flusso di Azure sia visibile in Estensioni abilitate.

  4. Selezionare l'icona di Azure sulla barra delle attività di Visual Studio Code. In Analisi di flusso sulla barra laterale selezionare Accedi ad Azure.

    Accedi ad Azure in Visual Studio Code

  5. Dopo aver eseguito l'accesso, il nome dell'account Azure viene visualizzato sulla barra di stato nell'angolo inferiore sinistro della finestra di Visual Studio Code.

Esportare un processo ASA e aprirlo in VS Code

Se è stato creato un processo ASA nel portale di Azure, è possibile esportare il processo ASA in VS Code nel computer locale. Due modi per esportare un job ASA

Opzione 1: esportare dal portale di Azure

  1. Accedere al portale di Azure e aprire il job ASA. Nella pagina Query selezionare Apri in VS Code per esportare il processo.

    Screenshot del portale di Azure con Open in VS Code per avviare VS Code nel computer locale.

  2. Selezionare una cartella in cui si vuole esportare il progetto ASA.

  3. Quindi creerà automaticamente un progetto ASA e lo aggiungerà all'area di lavoro in VS Code. Verrà visualizzata una cartella con lo stesso nome del processo ASA.

    Progetto ASA di esportazione di VS Code

  4. Un progetto di Analisi di flusso è costituito da tre cartelle: Input, Output e Funzioni. oltre che dallo script di query (*.asaql), da un file JobConfig.json e da un file di configurazione asaproj.json. Se sono state configurate più origini di input e output per il processo, verranno creati rispettivamente i file JSON per ogni origine nelle cartelle.

    Cartelle input e output di VS Code

Opzione 2- Esportare un processo ASA in VS Code

  1. Selezionare l'icona di Azure sulla barra delle attività di VS Code. Trovare la sottoscrizione in cui viene creato il processo ASA, quindi selezionare Esporta per esportare il processo ASA.

    Esportare un'attività ASA in VS Code

  2. Al termine dell'esportazione, verrà visualizzato un progetto ASA creato nell'area di lavoro.

    Attività ASA nell'area di lavoro di VS Code

  3. Se il processo ASA ha configurato più origini di input e output, creerà rispettivamente i file JSON per ogni origine nelle cartelle Input e Output.

Eseguire un'attività ASA in VS Code

Dopo l'esportazione di un processo ASA, è possibile eseguire la query nel computer locale. Per l'input, i dati possono essere acquisiti da file locali o origini live. I risultati di output vengono inviati come file a una cartella locale o ai sink live. Per altri dettagli, vedere Eseguire processi in locale con VS Code.

Seguire questa procedura per eseguire il processo con l'input attivo e salvare i risultati dell'output in locale:

  1. Prima di iniziare, installare .NET Core SDK e riavviare Visual Studio Code.

  2. Vai a. *.asaql file, selezionare Esegui localmente.

    Screenshot del codice di Visual Studio usando Esegui localmente per eseguire un processo ASA.

  3. Selezionare quindi Usa Input live e Output locale nella Palette comandi.

    Tavolozza dei comandi di VS Code

  4. Se il tuo lavoro è stato avviato con successo, puoi visualizzare i risultati di output, il diagramma del lavoro e le metriche per il tuo job ASA.

    Screenshot di Visual Studio Code con le funzionalità di diagramma di lavoro e metriche.

Per altre informazioni sul debug, vedere Eseguire il debug di query ASA in locale usando il diagramma dei processi

Domande frequenti

Come eseguire la migrazione di un progetto ASA locale da Visual Studio a VS Code?

Se si ha un progetto ASA locale in Visual Studio e non è ancora stato inviato, seguire questa procedura per inviare il progetto ASA ad Azure.

  1. Aprire il progetto ASA in Visual Studio. Le cartelle Funzioni, Input e Output verranno visualizzate in Esplora soluzioni.

    Esplora soluzioni di Visual Studio

  2. Aprire lo script (*.asaql) e selezionare Invia ad Azure nell'editor.

    VS Submit to Azure

  3. Selezionare Create a New Azure Stream Analytics job e immettere un Job Name. Scegliere sottoscrizione, gruppo di risorse e località per il progetto ASA.

    Progetto di salvataggio di Visual Studio

  4. Quindi puoi accedere al portale di Azure e trovare il processo ASA nel tuo gruppo di risorse.

  5. Per informazioni su come esportare un processo ASA in VS Code, vedere qui.

È necessario configurare le origini di input e output dopo l'esportazione di un processo ASA?

No, se il processo ASA ha configurato più origini input e output nel portale di Azure, creerà rispettivamente i file JSON per ogni origine nelle cartelle.

Come aggiungere una nuova origine di input in VS Code?

  1. Fare clic con il pulsante destro del mouse sulla cartella Input nel progetto di Analisi di flusso. Selezionare quindi ASA: Aggiungi input dal menu di scelta rapida.

    vscode aggiungi input

  2. Scegliere il tipo di input e seguire le istruzioni per modificare i file JSON di input.

    aggiungi codelens input in vscode

  3. È quindi possibile visualizzare in anteprima i dati e verificare se viene aggiunta la nuova origine di input.

    Screenshot di Visual Studio Code con i dati di anteprima.

Passaggi successivi

Per altre informazioni sugli strumenti di Analisi di flusso di Azure per Visual Studio Code, continuare con gli articoli seguenti: