You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# How to Migrate ASA projects to Visual Studio Code
12
12
13
-
This article provides guidance for Visual Studio users migrating Azure Stream Analytics (ASA) projects to Visual Studio Code (VSCode). Please note that the ASA Tools extension for Visual Studio is no longer maintained. We recommend that you use the ASA tools extension in VSCode for local testing before you submit and start an ASA job.
13
+
This article provides guidance for Visual Studio users migrating Azure Stream Analytics (ASA) projects to Visual Studio Code (VS Code). Please note that the ASA Tools extension for Visual Studio is no longer maintained. We recommend that you use the ASA tools extension in VS Code for local testing before you submit and start an ASA job.
14
14
15
15
If you have a local ASA project in Visual Studio, follow [these steps](#faqs) to submit your ASA project to Azure portal.
16
16
17
-
## Install VSCode and ASA Tools extension
17
+
## Install VS Code and ASA Tools extension
18
18
19
19
1. Install [Visual Studio Code](https://code.visualstudio.com/)
20
20
@@ -31,38 +31,38 @@ If you have a local ASA project in Visual Studio, follow [these steps](#faqs) to
31
31
5. When you're signed in, your Azure account name appears on the status bar in the lower-left corner of the Visual Studio Code window.
32
32
33
33
34
-
## Export an ASA Job and open in VSCode
34
+
## Export an ASA Job and open in VS Code
35
35
36
-
If you've created an ASA job in the Azure portal, you can export the ASA job to VSCode in your local machine. Two ways to export an ASA job:
36
+
If you've created an ASA job in the Azure portal, you can export the ASA job to VS Code in your local machine. Two ways to export an ASA job:
37
37
38
38
### Option 1 – Export from the Azure portal
39
39
40
40
1. Sign in to Azure portal and open your ASA job. Under **Query** page, select **Open in VS Code** to export job.
41
41
42
-
:::image type="content" source="./media/stream-analytics-migrate-to-vscode/portal-open-in-vscode.png" alt-text="Screenshot of the Azure portal using the Open in VSCode to launch VSCode in the local machine." lightbox= "./media/stream-analytics-migrate-to-vscode/portal-open-in-vscode.png" :::
42
+
:::image type="content" source="./media/stream-analytics-migrate-to-vscode/portal-open-in-vscode.png" alt-text="Screenshot of the Azure portal using the Open in VS Code to launch VS Code in the local machine." lightbox= "./media/stream-analytics-migrate-to-vscode/portal-open-in-vscode.png" :::
43
43
44
44
2. Select a folder where you want to export the ASA project.
45
-
3. Then it will automatically create an ASA project and add it to your workspace in VSCode. You should see a folder with the same name as your ASA job.
45
+
3. Then it will automatically create an ASA project and add it to your workspace in VS Code. You should see a folder with the same name as your ASA job.
4. A Stream Analytics project consists of three folders: **Inputs**, **Outputs**, and **Functions**. It also has the query script **(\*.asaql)**, a **JobConfig.json** file, and an **asaproj.json** configuration file. If you have configured multiple Input and Output sources for the job, it will create JSON files for each source under the folders respectively.
50
50
51
-

51
+

52
52
53
-
### Option 2 - Export an ASA job in VSCode
53
+
### Option 2 - Export an ASA job in VS Code
54
54
55
-
1. Select the **Azure** icon on the VSCode activity bar. Find the **Subscription** where your ASA job is created, select **Export** to export the ASA job.
55
+
1. Select the **Azure** icon on the VS Code activity bar. Find the **Subscription** where your ASA job is created, select **Export** to export the ASA job.
56
56
57
-

57
+

58
58
59
59
2. Once the export is completed, you'll see an ASA project created in your workspace.
60
60
61
-

61
+

62
62
63
63
3. If your ASA job has configured multiple input and output sources, it will create JSON files for each source under the **Inputs** and **Outputs** folders respectively.
64
64
65
-
## Run an ASA job in VSCode
65
+
## Run an ASA job in VS Code
66
66
67
67
After an ASA job is exported, you can run your query on the local machine. For input, data can be ingested from local files or live sources. Output results are either sent as files to a local folder, or to the live sinks. For more detail, visit [Run jobs locally with VS Code](./visual-studio-code-local-run-all.md).
68
68
@@ -85,7 +85,7 @@ For more details about debugging, visit [Debug ASA queries locally using job dia
85
85
86
86
## FAQs
87
87
88
-
### How to migrate a local ASA project from Visual Studio to VSCode?
88
+
### How to migrate a local ASA project from Visual Studio to VS Code?
89
89
90
90
If you have a local ASA project in Visual Studio and not yet submitted, follow these steps to submit your ASA project to Azure.
91
91
@@ -103,14 +103,14 @@ If you have a local ASA project in Visual Studio and not yet submitted, follow t
103
103
104
104
4. Then you can go to the Azure portal and find the ASA job under your **Resource Group**.
105
105
106
-
5. To learn how to export an ASA job in VSCode, see [here](#export-an-asa-job-and-open-in-vscode).
106
+
5. To learn how to export an ASA job in VS Code, see [here](#export-an-asa-job-and-open-in-vscode).
107
107
108
108
### Do I need to configure the input and output sources after an ASA job is exported?
109
109
110
110
No, if your ASA job has configured multiple Inputs and Outputs sources in the Azure portal, it will create JSON files for each source under the folders respectively.
111
111
112
112
113
-
### How to add a new input source in VSCode?
113
+
### How to add a new input source in VS Code?
114
114
115
115
1. Right-click the Inputs folder in your Stream Analytics project. Then select **ASA: Add Input** from the context menu.
0 commit comments