Muokkaa

Jaa

Add a cluster connection in the Azure Data Explorer web UI

  • Artikkeli

This article explains how to add a cluster connection in the Azure Data Explorer web UI.

The Azure Data Explorer web UI allows you to seamlessly manage clusters from various user accounts or Microsoft Entra directories. Follow the optional steps in this article to set up connections with alternative credentials. Once connected, you can switch between clusters associated with different credentials within a unified interface, without a need to repeatedly sign in and sign out or switch directories.

Prerequisites

  • A Microsoft account or a Microsoft Entra user identity. An Azure subscription isn't required.

Add a cluster connection

To add a connection to your Azure Data Explorer cluster:

  1. From the main left menu, select Query.

    Screenshot of the query widget in the main menu of the web UI.

  2. In the upper left corner, select Add. From the dropdown menu, select Connection.

  3. In the Add connection dialog box, enter the cluster Connection URI and Display name. 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.

    Screenshot of add cluster connection dialog box.

  4. (Optional) If you have multiple user accounts and want to authenticate with a different account, select Connect as another user, and proceed to add or select the appropriate account.

  5. (Optional) If your account is linked to multiple Microsoft Entra directories, select Switch directory and choose the relevant directory for this connection.

    Screenshot of option to switch directory.

  6. Select Add to add the connection. Your cluster and databases should now be visible in the left panel.

    For example, the following image shows a cluster connection pane that contains three clusters: HomeCluster, help, and TestCluster.

    Screenshot of the help cluster and databases.

Manage cluster connections

To organize and manage your clusters, you can add clusters to Favorites or to groups.

Manage cluster connections using Favorites

To add your cluster to Favorites:

  1. From the More [...] menu next to your cluster, select Add to favorites.

  2. Verify that your cluster appears under Favorites in the Cluster connection pane.

To remove a cluster from Favorites:

  1. Select the More [...] menu next to the cluster and then Remove from favorites.

  2. Verify that your cluster doesn't appear under Favorites in the Cluster connection pane.

    Screenshot of the Remove from favorites selection.

Manage cluster connections using groups

Before you start: If the group you wish to assign the cluster to doesn't exist, we recommend you create it first. In the Cluster connection pane, select Add > Group, enter a group name, and then select the check mark.

To add your cluster to a group:

  1. From the More [...] menu next to your cluster, select Add to group, and then select a group name.

    Screenshot of the add to group options. The add to group dropdown includes the New Group selection and an existing group.

  2. Verify that your cluster appears under the selected group in the Cluster connection pane.

To remove a cluster from a group:

  1. Select the More [...] menu next to the cluster, then Add to group. Under the Remove from group heading, select the group name.

    Screenshot of the Remove from group option.

  2. Verify that your cluster doesn't appear under the selected group in the Cluster connection pane.

Note

Clusters can be included in groups and Favorites at the same time.

Related content