Skip to content

Commit

Permalink
Merge pull request #6125 from MicrosoftDocs/main
Browse files Browse the repository at this point in the history
8/6/2024 AM Publish
  • Loading branch information
Taojunshen authored Aug 6, 2024
2 parents 66ac1e6 + 6fc2ee3 commit 8a76ed0
Show file tree
Hide file tree
Showing 4 changed files with 56 additions and 23 deletions.
33 changes: 33 additions & 0 deletions .github/workflows/bypass-codeowner-approval.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
name: Bypass Code Owner Approval
on:
pull_request:
types: [opened, synchronize, reopened]

jobs:
bypass_approval:
runs-on: ubuntu-latest
steps:
- name: Check if PR author is a code owner
id: check-author
run: |
TEAM_MEMBERS=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
https://api.github.com/orgs/MicrosoftDocs/teams/kusto-doc-writers/members)
if echo "$TEAM_MEMBERS" | grep -q "\"login\": \"${{ github.actor }}\""; then
DEBUG_IS_CODEOWNER=true
echo "is_codeowner=true" >> $GITHUB_ENV
else
DEBUG_IS_CODEOWNER=false
echo "is_codeowner=false" >> $GITHUB_ENV
fi
echo "::debug::Team members -- $TEAM_MEMBERS"
echo "::debug::is_codeowner -- $DEBUG_IS_CODEOWNER"
- name: Bypass approval if author is a code owner
id: bypass-approval
if: steps.check-author.outputs.is_codeowner == 'true'
run: |
echo "Bypassing approval for code owner"
curl -s -X POST -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
-H "Accept: application/vnd.github.v3+json" \
https://api.github.com/repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}/reviews \
-d '{"event":"APPROVE"}'
6 changes: 3 additions & 3 deletions data-explorer/add-query-visualization.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For a full list of available visuals, see [Visualization](kusto/query/render-ope

## Add a visual to a query

1. [Run a query](web-ui-query-overview.md#write-and-run-queries) in the Azure Data Explorer web UI. For example, you can use the following query:
1. [Run a query](web-ui-query-overview.md#write-and-run-queries) in the Azure Data Explorer web UI. For example, you can use the following query:

> [!div class="nextstepaction"]
> <a href="https://dataexplorer.azure.com/clusters/help/databases/Samples?query=H4sIAAAAAAAAAwsuyS/KdS1LzSsp5qpRKM9ILUpVCC5JLElVsLVVUPd29At2DFYHyhSX5uYmFmVWpYJYGi6JuYnpqQFF+QWpRSWVmgpJlQpgM0IqC1IBD28nVFIAAAA=" target="_blank">Run the query</a>
Expand Down Expand Up @@ -53,12 +53,12 @@ If you've added a visual through the UI, you can change this visual by selecting
### Visual created in query
If you've created a visual using the [render operator](kusto/query/render-operator.md), you can edit the visual by selecting **Visual** in the results grid.
If you've created a visual using the [render operator](kusto/query/render-operator.md), you can edit the visual by selecting **Visual** in the results grid.
:::image type="content" source="media/add-query-visualization/change-rendered-visual.png" alt-text="Screenshot of rendered visual as a bar chart that has been changed to a column chart in the visual formatting pane in Azure Data Explorer web UI." lightbox="media/add-query-visualization/change-rendered-visual.png":::
> [!IMPORTANT]
> Notice that the visual formatting pane has changed the visual representation, but has not modified the original query.
> Notice that the visual formatting pane has changed the visual representation, but has not modified the original query.
## Pin to dashboard
Expand Down
2 changes: 1 addition & 1 deletion data-explorer/dashboard-parameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ In the **Add parameter** pane, configure the following properties:
|**Data type**|The data type of the parameter values.|
|**Show on pages**|Select the pages where this parameter will be displayed. The **Select all** option shows the parameter on all pages.|
|**Source**|The source of the parameter values: <ul><li>**Fixed values**: Manually introduced static filter values. </li><li>**Query**: Dynamically introduced values using a KQL query.</li></ul>|
|**Default value**|The default value of the filter. The filter will start always with the default value upon initial rendering of the dashboard.
|**Default value**|The default value of the filter. The filter will start always with the default value upon initial rendering of the dashboard.|
|**Add a "Select all" value**|Applicable only to single selection and multiple selection parameter types. Used to retrieve data for all the parameter values. This value should be built into the query to provide the functionality. For more examples of building such queries, see [Use the multiple-selection query-based parameter](#multiple-selection-fixed-values-parameters).|

## Manage parameters
Expand Down
38 changes: 19 additions & 19 deletions data-explorer/data-factory-command-activity.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ ms.date: 09/13/2023

## Create a new pipeline

1. Select the **Author** pencil tool.
1. Select the **Author** pencil tool.
1. Create a new pipeline by selecting **+** and then select **Pipeline** from the drop-down.

![create new pipeline.](media/data-factory-command-activity/create-pipeline.png)
Expand All @@ -31,10 +31,10 @@ ms.date: 09/13/2023
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.

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

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

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.
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.

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

Expand All @@ -44,20 +44,20 @@ A [lookup activity](/azure/data-factory/control-flow-lookup-activity) can retrie
### Create an Azure Data Explorer dataset in lookup activity

1. In **Settings**, select your pre-created Azure Data Explorer **Source dataset**, or select **+ New** to create a new dataset.

![add dataset in lookup settings.](media/data-factory-command-activity/lookup-settings.png)

1. Select the **Azure Data Explorer (Kusto)** dataset from **New Dataset** window. Select **Continue** to add the new dataset.

![select new dataset.](media/data-factory-command-activity/select-new-dataset.png)
![select new dataset.](media/data-factory-command-activity/select-new-dataset.png)

1. The new Azure Data Explorer dataset parameters are visible in **Settings**. To update the parameters, select **Edit**.

![lookup settings with Azure Data Explorer dataset.](media/data-factory-command-activity/lookup-settings-with-adx-dataset.png)

1. The **AzureDataExplorerTable** new tab opens in the main canvas.
* Select **General** and edit the dataset name.
* Select **Connection** to edit the dataset properties.
1. The **AzureDataExplorerTable** new tab opens in the main canvas.
* Select **General** and edit the dataset name.
* Select **Connection** to edit the dataset properties.
* Select the **Linked service** from the drop-down, or select **+ New** to create a new linked service.

![Edit Azure Data Explorer dataset properties.](media/data-factory-command-activity/adx-dataset-properties-edit-connections.png)
Expand All @@ -67,8 +67,8 @@ A [lookup activity](/azure/data-factory/control-flow-lookup-activity) can retrie
![ Azure Data Explorer new linked service.](media/data-factory-command-activity/adx-new-linked-service.png)

* Select **Name** for Azure Data Explorer linked service. Add **Description** if needed.
* In **Connect via integration runtime**, change current settings, if needed.
* In **Account selection method** select your cluster using one of two methods:
* In **Connect via integration runtime**, change current settings, if needed.
* In **Account selection method** select your cluster using one of two methods:
* Select the **From Azure subscription** radio button and select your **Azure subscription** account. Then, select your **Cluster**. Note the drop-down will only list clusters that belong to the user.
* Instead, select **Enter manually** radio button and enter your **Endpoint** (cluster URL).
* Specify the **Tenant**.
Expand All @@ -92,15 +92,15 @@ A [lookup activity](/azure/data-factory/control-flow-lookup-activity) can retrie
| summarize count() by Database
```
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.
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.
![Final settings of lookup activity.](media/data-factory-command-activity/lookup-activity-final-settings.png)
## Create a For-Each activity
## Create a For-Each activity
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.
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.
1. Now you add a For-Each activity to the pipeline. This activity will process the data returned from the Lookup activity.
1. Now you add a For-Each activity to the pipeline. This activity will process the data returned from the Lookup activity.
* In the **Activities** pane, under **Iteration & Conditionals**, select the **ForEach** activity and drag and drop it into the canvas.
* Draw a line between the output of the Lookup activity and the input of the ForEach activity in the canvas to connect them.
Expand Down Expand Up @@ -140,7 +140,7 @@ The [For-Each](/azure/data-factory/control-flow-for-each-activity) activity is u
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).
The query addresses the database column of each row in the Lookup activity result. The **Command timeout** can be left unchanged.
![command activity.](media/data-factory-command-activity/command.png)
![command activity.](media/data-factory-command-activity/command.png)
> [!NOTE]
> The command activity has the following limits:
Expand All @@ -156,15 +156,15 @@ The [For-Each](/azure/data-factory/control-flow-for-each-activity) activity is u
![azure data explorer command activity output.](media/data-factory-command-activity/command-activity-output.png)
1. You can **Publish All** and then **Add trigger** to run the pipeline.
1. You can **Publish All** and then **Add trigger** to run the pipeline.
## Management command outputs
The structure of the command activity output is detailed below. This output can be used by the next activity in the pipeline.
### Returned value of a non-async management command
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.
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.
```json
{
Expand Down Expand Up @@ -209,9 +209,9 @@ In an async management command, the activity polls the operations table behind t
}
]
}
```
```

## Related content

* [Copy data to Azure Data Explorer using Azure Data Factory](data-factory-load-data.md).
* [Azure Data Factory template for bulk copy from database to Azure Data Explorer](data-factory-template.md).
* [Azure Data Factory template for bulk copy from database to Azure Data Explorer](data-factory-template.md).

0 comments on commit 8a76ed0

Please sign in to comment.