Skip to content

Commit e98f5e9

Browse files
Merge pull request #2856 from MicrosoftDocs/main639076399670978995sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents d8d3bab + fb8fe51 commit e98f5e9

12 files changed

Lines changed: 102 additions & 101 deletions

data-explorer/cluster-encryption-disk.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,9 @@ Your cluster security settings allow you to enable disk encryption on your clust
2828
2929
## Considerations
3030

31-
The following considerations apply to encryption using Azure Disk Encryption:
31+
The following consideration apply to encryption using Azure Disk Encryption:
3232

3333
* Performance impact of up to a single digit
34-
* Can't be used with sandboxes
3534

3635
## Related content
3736

data-explorer/data-factory-command-activity.md

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
2-
title: 'Use Azure Data Explorer management commands in Azure Data Factory'
3-
description: 'In this topic, use Azure Data Explorer management commands in Azure Data Factory'
2+
title: Use Azure Data Explorer Management Commands in Azure Data Factory
3+
description: In this topic, use Azure Data Explorer management commands in Azure Data Factory
44
ms.reviewer: tzgitlin
55
ms.topic: how-to
6-
ms.date: 09/13/2023
6+
ms.date: 02/23/2026
77
ms.custom: sfi-image-nochange
88

99
#Customer intent: I want to use Azure Data Explorer management commands in Azure Data Factory.
1010
---
1111

1212
# Use Azure Data Factory command activity to run Azure Data Explorer management commands
1313

14-
[Azure Data Factory](/azure/data-factory/) (ADF) is a cloud-based data integration service that allows you to perform a combination of activities on the data. Use ADF to create data-driven workflows for orchestrating and automating data movement and data transformation. The **Azure Data Explorer Command** activity in Azure Data Factory enables you to run [Azure Data Explorer management commands](/kusto/query/index?view=azure-data-explorer&preserve-view=true#management-commands) within an ADF workflow. This article teaches you how to create a pipeline with a lookup activity and ForEach activity containing an Azure Data Explorer command activity.
14+
[Azure Data Factory](/azure/data-factory/) (ADF) is a cloud-based data integration service that you can use to perform a combination of activities on the data. Use ADF to create data-driven workflows for orchestrating and automating data movement and data transformation. The **Azure Data Explorer Command** activity in Azure Data Factory enables you to run [Azure Data Explorer management commands](/kusto/query/index?view=azure-data-explorer&preserve-view=true#management-commands) within an ADF workflow. This article shows you how to create a pipeline with a lookup activity and ForEach activity containing an Azure Data Explorer command activity.
1515

1616
## Prerequisites
1717

@@ -29,18 +29,18 @@ ms.custom: sfi-image-nochange
2929

3030
## Create a Lookup activity
3131

32-
A [lookup activity](/azure/data-factory/control-flow-lookup-activity) can retrieve a dataset from any Azure Data Factory-supported data sources. The output from Lookup activity can be used in a ForEach or other activity.
32+
A [lookup activity](/azure/data-factory/control-flow-lookup-activity) can retrieve a dataset from any Azure Data Factory-supported data source. You can use the output from the Lookup activity in a ForEach or other activity.
3333

3434
1. In the **Activities** pane, under **General**, select the **Lookup** activity. Drag and drop it into the main canvas on the right.
3535

3636
![select lookup activity.](media/data-factory-command-activity/select-activity.png)
3737

38-
1. The canvas now contains the Lookup activity you created. Use the tabs below the canvas to change any relevant parameters. In **General**, rename the activity.
38+
1. The canvas now contains the Lookup activity you created. Use the tabs under the canvas to change any relevant parameters. In **General**, rename the activity.
3939

4040
![edit lookup activity.](media/data-factory-command-activity/edit-lookup-activity.png)
4141

4242
> [!TIP]
43-
> Click on the empty canvas area to view the pipeline properties. Use the **General** tab to rename the pipeline. Our pipeline is named *pipeline-4-docs*.
43+
> Select the empty canvas area to view the pipeline properties. Use the **General** tab to rename the pipeline. The pipeline is named *pipeline-4-docs*.
4444
4545
### Create an Azure Data Explorer dataset in lookup activity
4646

@@ -70,44 +70,44 @@ A [lookup activity](/azure/data-factory/control-flow-lookup-activity) can retrie
7070
* Select **Name** for Azure Data Explorer linked service. Add **Description** if needed.
7171
* In **Connect via integration runtime**, change current settings, if needed.
7272
* In **Account selection method** select your cluster using one of two methods:
73-
* Select the **From Azure subscription** radio button and select your **Azure subscription** account. Then, select your **Cluster**. Note the dropdown will only list clusters that belong to the user.
73+
* Select the **From Azure subscription** radio button and select your **Azure subscription** account. Then, select your **Cluster**. The dropdown only lists clusters that belong to you.
7474
* Instead, select **Enter manually** radio button and enter your **Endpoint** (cluster URL).
7575
* Specify the **Tenant**.
76-
* Enter **Service principal ID**. This value can be found in the [Azure portal](https://ms.portal.azure.com/) under **App Registrations** > **Overview** > **Application (client) ID**. The principal must have the adequate permissions, according to the permission level required by the command being used.
76+
* Enter **Service principal ID**. Find this value in the [Azure portal](https://ms.portal.azure.com/) under **App Registrations** > **Overview** > **Application (client) ID**. The principal must have the adequate permissions, according to the permission level required by the command being used.
7777
* Select **Service principal key** button and enter **Service Principal Key**.
7878
* Select your **Database** from the dropdown menu. Alternatively, select **Edit** checkbox and enter your database name.
79-
* Select **Test Connection** to test the linked service connection you created. If you can connect to your setup, a green checkmark **Connection successful** will appear.
79+
* Select **Test Connection** to test the linked service connection you created. If you can connect to your setup, a green checkmark **Connection successful** appears.
8080
* Select **Finish** to complete linked service creation.
8181

82-
1. Once you've set up a linked service, In **AzureDataExplorerTable** > **Connection**, add **Table** name. Select **Preview data**, to make sure that the data is presented properly.
82+
1. After you set up a linked service, In **AzureDataExplorerTable** > **Connection**, add **Table** name. Select **Preview data**, to make sure that the data is presented properly.
8383

84-
Your dataset is now ready, and you can continue editing your pipeline.
84+
Your dataset is ready, and you can continue editing your pipeline.
8585

8686
### Add a query to your lookup activity
8787

88-
1. In **pipeline-4-docs** > **Settings** add a query in **Query** text box, for example:
88+
1. In **pipeline-4-docs** > **Settings**, add a query in the **Query** text box, for example:
8989

9090
```kusto
9191
ClusterQueries
9292
| where Database !in ("KustoMonitoringPersistentDatabase", "$systemdb")
9393
| summarize count() by Database
9494
```
9595
96-
1. Change the **Query timeout** or **No truncation** and **First row only** properties, as needed. In this flow, we keep the default **Query timeout** and uncheck the checkboxes.
96+
1. Change the **Query timeout** or **No truncation** and **First row only** properties, as needed. In this flow, keep the default **Query timeout** and uncheck the checkboxes.
9797
9898
![Final settings of lookup activity.](media/data-factory-command-activity/lookup-activity-final-settings.png)
9999
100100
## Create a For-Each activity
101101
102-
The [For-Each](/azure/data-factory/control-flow-for-each-activity) activity is used to iterate over a collection and execute specified activities in a loop.
102+
Use the [For-Each](/azure/data-factory/control-flow-for-each-activity) activity to iterate over a collection and execute specified activities in a loop.
103103
104-
1. Now you add a For-Each activity to the pipeline. This activity will process the data returned from the Lookup activity.
105-
* In the **Activities** pane, under **Iteration & Conditionals**, select the **ForEach** activity and drag and drop it into the canvas.
104+
1. Add a For-Each activity to the pipeline. This activity processes the data returned from the Lookup activity.
105+
* In the **Activities** pane, under **Iteration & Conditionals**, select the **ForEach** activity. Drag and drop it into the canvas.
106106
* Draw a line between the output of the Lookup activity and the input of the ForEach activity in the canvas to connect them.
107107
108108
![ForEach activity.](media/data-factory-command-activity/for-each-activity.png)
109109
110-
1. Select the ForEach activity in the canvas. In the **Settings** tab below:
110+
1. Select the ForEach activity in the canvas. In the **Settings** tab:
111111
* Check the **Sequential** checkbox for a sequential processing of the Lookup results, or leave it unchecked to create parallel processing.
112112
* Set **Batch count**.
113113
* In **Items**, provide the following reference to the output value:
@@ -117,12 +117,12 @@ The [For-Each](/azure/data-factory/control-flow-for-each-activity) activity is u
117117
118118
## Create an Azure Data Explorer Command activity within the ForEach activity
119119
120-
1. Double-click the ForEach activity in the canvas to open it in a new canvas to specify the activities within ForEach.
120+
1. Double-click the ForEach activity in the canvas to open it in a new canvas. Specify the activities within ForEach.
121121
1. In the **Activities** pane, under **Azure Data Explorer**, select the **Azure Data Explorer Command** activity and drag and drop it into the canvas.
122122
123123
![Azure Data Explorer command activity.](media/data-factory-command-activity/adx-command-activity.png)
124124
125-
1. In the **Connection** tab, select the same Linked Service previously created.
125+
1. In the **Connection** tab, select the same Linked Service you previously created.
126126
127127
![azure data explorer command activity connection tab.](media/data-factory-command-activity/adx-command-activity-connection-tab.png)
128128
@@ -139,33 +139,33 @@ The [For-Each](/azure/data-factory/control-flow-for-each-activity) activity is u
139139
```
140140
141141
The **Command** instructs Azure Data Explorer to export the results of a given query into a blob storage, in a compressed format. It runs asynchronously (using the async modifier).
142-
The query addresses the database column of each row in the Lookup activity result. The **Command timeout** can be left unchanged.
142+
The query addresses the database column of each row in the Lookup activity result. You can leave the **Command timeout** unchanged.
143143
144144
![command activity.](media/data-factory-command-activity/command.png)
145145
146146
> [!NOTE]
147147
> The command activity has the following limits:
148148
> * Size limit: 1 MB response size
149149
> * Time limit: 20 minutes (default), 1 hour (maximum).
150-
> * If needed, you can append a query to the result using [AdminThenQuery](/kusto/management/index?view=azure-data-explorer&preserve-view=true#combining-queries-and-management-commands), to reduce resulting size/time.
150+
> * If needed, you can append a query to the result using [AdminThenQuery](/kusto/management/index?view=azure-data-explorer&preserve-view=true#combining-queries-and-management-commands), to reduce resulting size or time.
151151
152-
1. Now the pipeline is ready. You can go back to the main pipeline view by clicking the pipeline name.
152+
1. Now the pipeline is ready. You can go back to the main pipeline view by selecting the pipeline name.
153153
154154
![Azure Data Explorer command pipeline.](media/data-factory-command-activity/adx-command-pipeline.png)
155155
156-
1. Select **Debug** before publishing the pipeline. The pipeline progress can be monitored in the **Output** tab.
156+
1. Select **Debug** before publishing the pipeline. You can monitor the pipeline progress in the **Output** tab.
157157
158158
![azure data explorer command activity output.](media/data-factory-command-activity/command-activity-output.png)
159159
160-
1. You can **Publish All** and then **Add trigger** to run the pipeline.
160+
1. Select **Publish All** and then **Add trigger** to run the pipeline.
161161
162162
## Management command outputs
163163
164-
The structure of the command activity output is detailed below. This output can be used by the next activity in the pipeline.
164+
The following section describes the structure of the command activity output. The next activity in the pipeline can use this output.
165165
166166
### Returned value of a non-async management command
167167
168-
In a non-async management command, the structure of the returned value is similar to the structure of the Lookup activity result. The `count` field indicates the number of returned records. A fixed array field `value` contains a list of records.
168+
In a non-async management command, the structure of the returned value is similar to the structure of the Lookup activity result. The `count` field shows the number of returned records. A fixed array field `value` contains a list of records.
169169
170170
```json
171171
{
@@ -187,7 +187,7 @@ In a non-async management command, the structure of the returned value is simila
187187

188188
### Returned value of an async management command
189189

190-
In an async management command, the activity polls the operations table behind the scenes, until the async operation is completed or times-out. Therefore, the returned value will contain the result of `.show operations OperationId` for that given **OperationId** property. Check the values of **State** and **Status** properties, to verify successful completion of the operation.
190+
In an async management command, the activity polls the operations table behind the scenes, until the async operation is completed or times out. Therefore, the returned value contains the result of `.show operations OperationId` for that given **OperationId** property. Check the values of **State** and **Status** properties, to verify successful completion of the operation.
191191

192192
```json
193193
{

data-explorer/excel.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: 'Visualize a Query in Excel'
3-
description: 'In this article, you learn how to use a query from the web UI into Excel, by exporting it directly or by using the native connector in Excel.'
2+
title: Visualize a Query in Excel
3+
description: In this article, you learn how to use a query from the web UI into Excel, by exporting it directly or by using the native connector in Excel.
44
ms.reviewer: orspodek
55
ms.topic: how-to
6-
ms.date: 02/08/2026
6+
ms.date: 02/23/2026
77

88
# Customer intent: As a data analyst, I want to understand how to visualize my Azure Data Explorer data in Excel.
99
---
@@ -30,7 +30,7 @@ Export the query directly from the web UI.
3030

3131
:::image type="content" source="media/excel/web-ui-query-to-excel.png" alt-text="Screenshot that shows Azure Data Explorer web UI query to Open in Excel." lightbox="media/excel/web-ui-query-to-excel.png":::
3232

33-
The query is saved as an Excel workbook in the Downloads folder.
33+
The query is saved as an Excel workbook in the **Downloads** folder.
3434

3535
1. Open the downloaded workbook to view your data. Select **Enable editing** and **Enable content** if requested in the top ribbon.
3636

@@ -69,7 +69,7 @@ Get data from Azure Data Explorer datasource into Excel.
6969

7070
:::image type="content" source="media/excel/complete-sign-in.png" alt-text="Screenshot that shows that show the sign-in pop-up window.":::
7171

72-
1. In the **Navigator** pane, navigate to the correct table. In the table preview pane, select **Transform Data** to open the **Power Query Editor** and make changes to your data, or select **Load** to load it straight to Excel.
72+
1. In the **Navigator** pane, go to the correct table. In the table preview pane, select **Transform Data** to open the **Power Query Editor** and make changes to your data, or select **Load** to load it straight to Excel.
7373

7474
:::image type="content" source="media/excel/navigate-table-preview-window.png" alt-text="Screenshot of the Table preview window.":::
7575

data-explorer/flow-usage.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Usage examples for Azure Data Explorer connector to Power Automate
33
description: Learn some common usage examples for Azure Data Explorer connector to Power Automate.
44
ms.reviewer: miwalia
55
ms.topic: how-to
6-
ms.date: 05/04/2022
6+
ms.date: 02/23/2026
77
no-loc: [Power Automate]
88
ms.custom: sfi-image-nochange
99
---
@@ -18,14 +18,14 @@ For more information, see [Azure Data Explorer Power Automate connector](flow.md
1818

1919
Use the Power Automate connector to query your data and aggregate it in an SQL database.
2020

21-
> [!Note]
21+
> [!NOTE]
2222
> Only use the Power Automate connector for small amounts of output data. The SQL insert operation is done separately for each row.
2323
2424
:::image type="content" source="media/flow-usage/flow-sql-example.png" alt-text="Screenshot of SQL connector, showing querying data by using the Power Automate connector.":::
2525

2626
## Push data to a Microsoft Power BI dataset
2727

28-
You can use the Power Automate connector with the Power BI connector to push data from Kusto queries to Power BI streaming datasets.
28+
Use the Power Automate connector with the Power BI connector to push data from Kusto queries to Power BI streaming datasets.
2929

3030
1. Create a new **Run query and list results** action.
3131
1. Select **New step**.
@@ -34,7 +34,7 @@ You can use the Power Automate connector with the Power BI connector to push dat
3434

3535
:::image type="content" source="media/flow-usage/flow-power-bi-connector.png" alt-text="Screenshot of Power BI connector, showing add row to a dataset action.":::
3636

37-
1. Enter the **Workspace**, **Dataset**, and **Table** to which data will be pushed.
37+
1. Enter the **Workspace**, **Dataset**, and **Table** to which you want to push data.
3838
1. From the dynamic content dialog box, add a **Payload** that contains your dataset schema and the relevant Kusto query results.
3939

4040
:::image type="content" source="media/flow-usage/flow-power-bi-fields.png" alt-text="Screenshot of Power BI action, showing action fields.":::
@@ -47,8 +47,8 @@ The flow automatically applies the Power BI action for each row of the Kusto que
4747

4848
You can use the results of Kusto queries as input or conditions for the next Power Automate actions.
4949

50-
In the following example, we query Kusto for incidents that occurred during the last day. For each resolved incident, a Slack message is posted and a push notification is created.
51-
For each incident that is still active, we query Kusto for more information about similar incidents. It sends that information as an email, and opens a related task in Azure DevOps Server.
50+
In the following example, you query Kusto for incidents that occurred during the last day. For each resolved incident, the flow posts a Slack message and creates a push notification.
51+
For each incident that is still active, the flow queries Kusto for more information about similar incidents. It sends that information as an email, and opens a related task in Azure DevOps Server.
5252

5353
Follow these instructions to create a similar flow:
5454

@@ -65,7 +65,7 @@ Follow these instructions to create a similar flow:
6565
:::image type="content" source="media/flow-usage/flow-condition-actions-inline.png" alt-text="Screenshot showing adding actions for when a condition is true or false, flow conditions based on Kusto query results." lightbox="media/flow-usage/flow-condition-actions.png":::
6666

6767
You can use the result values from the Kusto query as input for the next actions. Select the result values from the dynamic content window.
68-
In the following example, we add a **Slack - Post Message** action and a **Visual Studio - Create a new work item** action, containing data from the Kusto query.
68+
In the following example, you add a **Slack - Post Message** action and a **Visual Studio - Create a new work item** action, containing data from the Kusto query.
6969

7070
:::image type="content" source="media/flow-usage/flow-slack.png" alt-text="Screenshot of Slack - Post Message action.":::
7171

0 commit comments

Comments
 (0)