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
Copy file name to clipboardExpand all lines: data-explorer/web-share-queries.md
+49-33Lines changed: 49 additions & 33 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,28 @@
1
1
---
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.'
4
4
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
6
11
---
7
12
8
13
# Share queries from Azure Data Explorer web UI
9
14
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).
11
25
12
-
To learn how to run queries, see [Quickstart: Query data in the Azure Data Explorer web UI](web-query-data.md).
13
26
14
27
## Prerequisites
15
28
@@ -23,9 +36,9 @@ The following table outlines the many options for how to share a query.
23
36
|Action|Description|
24
37
|--|--|
25
38
|[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. |
29
42
|[Download](#download)|Download a KQL file of the query.|
30
43
|[Open in Excel](#open-in-excel)|Open a live query in an Excel workbook that can be refreshed directly from Excel.|
31
44
|[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:
50
63
> [!NOTE]
51
64
> **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.
52
65
53
-
## Link to clipboard
66
+
## Copy query link to clipboard
54
67
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:
56
69
57
70
1. In the query window, select the query that you want to share.
71
+
1. Select **Copy** on the toolbar.
58
72
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**.
60
75
61
76
:::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
-
63
77
1. Paste the link into a new browser window to run the query.
64
78
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).
67
82
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
69
87
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:
71
89
72
90
1. In the query window, select the query that you want to share.
91
+
1. Select **Copy** on the toolbar.
73
92
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**.
75
95
76
96
:::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:
77
98
78
-
1. Paste to share. The output lists the link followed by the query text.
99
+
```kusto
100
+
StormEvents
101
+
| take 3
102
+
```
103
+
79
104
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
87
106
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:
89
108
90
109
1. In the query window, select the query that you want to share.
110
+
1. Select **Copy** on the toolbar.
91
111
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**.
93
114
94
115
:::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.
95
117
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).
100
118
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.
0 commit comments