Skip to content

Commit 8785ed8

Browse files
Merge pull request #7064 from MicrosoftDocs/main
Auto Publish – main to live - 2025-08-25 22:00 UTC
2 parents 8fc579f + 6475613 commit 8785ed8

File tree

5 files changed

+49
-33
lines changed

5 files changed

+49
-33
lines changed
6.73 KB
Loading
-2.32 KB
Loading
378 Bytes
Loading
34.9 KB
Loading

data-explorer/web-share-queries.md

Lines changed: 49 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,28 @@
11
---
2-
title: 'Share queries from Azure Data Explorer web UI'
3-
description: This guide teaches you how to share queries from the Azure Data Explorer web UI.
2+
title: Share Queries From Azure Data Explorer Web UI
3+
description: 'Share queries from the Azure Data Explorer web UI: learn to copy links, export results, pin to dashboards, or open live in Excel.'
44
ms.topic: how-to
5-
ms.date: 03/03/2025
5+
ms.date: 08/25/2025
6+
ms.custom:
7+
- ai-gen-docs-bap
8+
- ai-gen-title
9+
- ai-seo-date:08/25/2025
10+
- ai-gen-description
611
---
712

813
# Share queries from Azure Data Explorer web UI
914

10-
This article describes the process of sharing queries from the [Azure Data Explorer web UI](https://dataexplorer.azure.com/home). By the end of this article, you'll know how to share a query link, share the query results, or even pin it to a dashboard.
15+
This article shows you how to use [Azure Data Explorer web UI](https://dataexplorer.azure.com/) to:
16+
17+
- Copy a link that runs the query in protected (read-only) mode.
18+
- Copy the query text or the query results to the clipboard.
19+
- Download the query as a KQL file or export results to CSV.
20+
- Open a live query in Excel and refresh results from the cluster.
21+
- Pin a query to an Azure Data Explorer dashboard.
22+
23+
> [!NOTE]
24+
> To learn how to run queries, see [Quickstart: Query data in the Azure Data Explorer web UI](web-query-data.md).
1125
12-
To learn how to run queries, see [Quickstart: Query data in the Azure Data Explorer web UI](web-query-data.md).
1326

1427
## Prerequisites
1528

@@ -23,9 +36,9 @@ The following table outlines the many options for how to share a query.
2336
|Action|Description|
2437
|--|--|
2538
|[Pin to dashboard](#pin-to-dashboard)|Display the query in an [Azure Data Explorer dashboard](azure-data-explorer-dashboards.md).|
26-
|[Link to clipboard](#link-to-clipboard)|Copy a link that can be used to run the query.|
27-
|[Link, query to clipboard](#link-query-to-clipboard)|Copy a link that can be used to run the query and the text of the query. For enhanced security, the shared query opens in Azure Data Explorer in **Protected mode**. |
28-
|[Link, query, results to clipboard](#link-query-results-to-clipboard)|Copy a link that can be used to run the query, the text of the query, and the results of the query. For enhanced security, the shared query opens in Azure Data Explorer in protected mode. |
39+
|[Copy query link to clipboard](#copy-query-link-to-clipboard)|Copy a link that can be used to run the query to the clipboard. For enhanced security, the shared query opens in Azure Data Explorer in **Protected mode**. |
40+
|[Copy query text to clipboard](#copy-query-text-to-clipboard)|Copy text of the query to the clipboard. |
41+
|[Copy query results to clipboard](#copy-query-results-to-clipboard)|Copy results of the query to the clipboard. For enhanced security, the shared query opens in Azure Data Explorer in protected mode. |
2942
|[Download](#download)|Download a KQL file of the query.|
3043
|[Open in Excel](#open-in-excel)|Open a live query in an Excel workbook that can be refreshed directly from Excel.|
3144
|[Export to CSV](#export-to-csv)|Download a CSV of the query results.|
@@ -50,56 +63,59 @@ To pin a query to a dashboard for continuous monitoring, follow these steps:
5063
> [!NOTE]
5164
> **Pin to dashboard** only pins the selected query. To create the dashboard data source and translate render commands to a visual in the dashboard, the relevant database must be selected in the database list.
5265
53-
## Link to clipboard
66+
## Copy query link to clipboard
5467

55-
To copy a link to share with others, follow these steps:
68+
To copy a link to the query to the clipboard, follow these steps:
5669

5770
1. In the query window, select the query that you want to share.
71+
1. Select **Copy** on the toolbar.
5872

59-
1. Under **Copy**, select **Link to clipboard**.
73+
:::image type="content" source="media/web-share-query/select-copy.png" alt-text="Screenshot of the pin query window with the copy button on the toolbar highlighted." lightbox="media/web-share-query/select-copy.png":::
74+
1. In the **Copy Query** window, select the **Copy Link** option, and then select **Copy**.
6075

6176
:::image type="content" source="media/web-share-query/link-to-clipboard.png" alt-text="Screenshot of the link to clipboard button." lightbox="media/web-share-query/link-to-clipboard.png":::
62-
6377
1. Paste the link into a new browser window to run the query.
6478

65-
> [!NOTE]
66-
> The user must have access to the cluster to run the query.
79+
> [!NOTE]
80+
> - The user must have access to the cluster to run the query.
81+
> - The query link request is generated with `request_readonly_hardline` set to `true`, ensuring it operates in strict read-only mode for enhanced security in protected mode. The **Protected mode** banner displays above the query and an icon appears in the query tab when protected mode is enabled. For more information about this request property, see [Request properties](/azure/data-explorer/kusto/api/rest/request-properties).
6782
68-
## Link, query to clipboard
83+
> [!TIP]
84+
> You can open the shared query as a [Fabric Real-Time Intelligence](/fabric/real-time-intelligence/overview) link. This feature allows you to experiment with a trial Fabric Real-Time Intelligence account using your own data, without the need to move any data.
85+
86+
## Copy query text to clipboard
6987

70-
To copy a link to share with others and the text of the query, follow these steps:
88+
To copy the text of the query to clipboard, follow these steps:
7189

7290
1. In the query window, select the query that you want to share.
91+
1. Select **Copy** on the toolbar.
7392

74-
1. Under **Copy**, select **Link, query to clipboard**.
93+
:::image type="content" source="media/web-share-query/select-copy.png" alt-text="Screenshot of the pin query window with the copy button on the toolbar highlighted." lightbox="media/web-share-query/select-copy.png":::
94+
1. In the **Copy Query** window, select the **Copy Query** option, and then select **Copy**.
7595

7696
:::image type="content" source="media/web-share-query/link-query-to-clipboard.png" alt-text="Screenshot of the link, query to clipboard button." lightbox="media/web-share-query/link-query-to-clipboard.png":::
97+
1. Paste to share. The output lists the query text. For example:
7798

78-
1. Paste to share. The output lists the link followed by the query text.
99+
```kusto
100+
StormEvents
101+
| take 3
102+
```
103+
79104
80-
> [!NOTE]
81-
> The query link request is generated with `request_readonly_hardline` set to `true`, ensuring it operates in strict read-only mode for enhanced security in protected mode. The **Protected mode** banner displays above the query and an icon appears in the query tab when protected mode is enabled. For more information about this request property, see [Request properties](/azure/data-explorer/kusto/api/rest/request-properties).
82-
83-
> [!TIP]
84-
> You can open the shared query as a [Fabric Real-Time Intelligence](/fabric/real-time-intelligence/overview) link. This feature allows you to experiment with a trial Fabric Real-Time Intelligence account using your own data, without the need to move any data.
85-
86-
## Link, query, results to clipboard
105+
## Copy query results to clipboard
87106
88-
To copy a link to share with others, the text of the query, and the results of the query, follow these steps:
107+
To copy results of the query to the clipboard, follow these steps:
89108
90109
1. In the query window, select the query that you want to share.
110+
1. Select **Copy** on the toolbar.
91111
92-
1. Under **Copy**, select **Link, query, results to clipboard**.
112+
:::image type="content" source="media/web-share-query/select-copy.png" alt-text="Screenshot of the pin query window with the copy button on the toolbar highlighted." lightbox="media/web-share-query/select-copy.png":::
113+
1. In the **Copy Query** window, select the **Query Results** option, and then select **Copy**.
93114
94115
:::image type="content" source="media/web-share-query/link-query-results-to-clipboard.png" alt-text="Screenshot of the link, query, results to clipboard button." lightbox="media/web-share-query/link-query-results-to-clipboard.png":::
116+
1. Paste to share. The output lists the query results.
95117
96-
1. Paste to share. The output lists the link, query text, and query results.
97-
98-
> [!NOTE]
99-
> The query link request is generated with `request_readonly_hardline` set to `true`, ensuring it operates in strict read-only mode for enhanced security in protected mode. The **Protected mode** banner displays above the query and an icon appears in the query tab when protected mode is enabled. For more information about this request property, see [Request properties](/azure/data-explorer/kusto/api/rest/request-properties).
100118
101-
> [!TIP]
102-
> You can open the shared query as a [Fabric Real-Time Intelligence](/fabric/real-time-intelligence/overview) link. This feature allows you to experiment with a trial Fabric Real-Time Intelligence account using your own data, without the need to move any data.
103119
104120
## Download
105121

0 commit comments

Comments
 (0)