Query data in a KQL queryset

In this article, you learn how to use a KQL queryset. The KQL Queryset is the item used to run queries, view, and customize query results on data from a KQL database.

The KQL Queryset uses the Kusto Query Language for creating queries, and also supports many SQL functions. For more information about the query language, see Kusto Query Language overview.

Prerequisites

• A workspace with a Microsoft Fabric-enabled capacity
• A KQL database with editing permissions and data, or an Azure Data Explorer cluster and database with AllDatabaseAdmin permissions.

Select a database

Queries run in the context of a database. You can change the associated database at any point, and retain the queries saved in the query editor. You can associate your KQL queryset with a KQL database or a database from an Azure Data Explorer cluster.

Select the tab that corresponds with your desired database type.

KQL Database

1. Open your KQL queryset.

2. Under Database, select V to expand the database connections menu.

   

3. Under Connect source, select OneLake data hub.

4. In the OneLake data hub window that appears, select a KQL database, and then select Select.

   

Azure Data Explorer cluster

1. Open your KQL queryset.

2. Under Database, select V to expand the database connections menu.

   

3. Under Connect source, select Azure Data Explorer.

4. Under Connection URI, enter the cluster URI.

   To find the connection URI, go to your cluster resource in the Azure portal. The connection URI is the URI found in the Overview. To add a free sample cluster, specify "help" as the Connection URI.

   

5. Under Database, select the dropdown menu to expand the list of databases in your cluster, and then select a database.

6. Select Connect.

A list of tables associated with this database will appear below the database name.

Write a query

Now that you're connected to your data source, you can run queries on this data. The KQL Queryset uses the Kusto Query Language (KQL) to query data from any of the databases you have access to. To learn more about KQL, see Kusto Query Language overview.

The following examples use data that is publicly available at https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Write or copy a query in the top pane of the KQL Queryset.

2. Select the Run button, or press Shift+Enter to run the query.

   The resulting query output is displayed in the results grid, which appears below the query pane. Notice the green check indicating that the query has finished successfully, and time used to compute the query results.

   

Manage queryset tabs

Within a KQL queryset, you can create multiple tabs. Each tab can be associated with a different KQL database, and lets you save queries for later use or share with others to collaborate on data exploration. You can also change the KQL database associated with any tab, allowing you to run the same query on data in different states.

• Rename a tab: Select the pencil icon next to the tab name.
• Add a new tab: Select the plus + to the right of the existing tabs. Different tabs can be connected to different databases.
• Change the existing database connection: Under Database, select the existing database connection to open the data hub.

Copy query

You might want to copy or share the queries you create.

1. At the top of the query window, select the Home tab.

2. Select Copy query.

   

   The following table outlines the many options for how to share a query.

   Important

   The user who is receiving the query link must have viewing permissions to the underlying data to execute the query and view results.

   Action	Description
   Copy query	Copy the query text.
   Link to clipboard	Copy a deep link that can be used to run the query.
   Link and query to clipboard	Copy a link that can be used to run the query and the text of the query.
   Link, query and 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.
   Copy results	Copy the results of the query.

3. Select the desired sharing action from the above table.

4. Paste this information into any editor, such as Microsoft Word.

Export query data as CSV

Instead of simply copy-pasting the query output, you can also export the query results.

This is a one-time method to export a CSV file containing the query results.

1. At the top of the query window, select the Manage tab.

   

2. Select Export results to CSV.

3. Save the CSV file locally.

Delete KQL queryset

To delete your KQL queryset:

1. Select the workspace to which your KQL queryset is associated.

2. Hover over the KQL queryset you wish to delete. Select More [...], then select Delete.

   

Next step

Customize results in the KQL Queryset results grid