|
| 1 | +--- |
| 2 | +title: SQL Server Connection Summary |
| 3 | +description: Learn how you can see a summary of client connections made to an instance of SQL Server enabled by Azure Arc in the Azure portal by using the SQL Server Connections view. |
| 4 | +author: ajithkr-ms |
| 5 | +ms.author: ajithkr |
| 6 | +ms.reviewer: nhebbar, randolphwest |
| 7 | +ms.date: 03/26/2025 |
| 8 | +ms.topic: how-to |
| 9 | +ms.custom: |
| 10 | +--- |
| 11 | + |
| 12 | +# Client connection summary for SQL Server enabled by Azure Arc (preview) |
| 13 | + |
| 14 | +[!INCLUDE [sqlserver](../../includes/applies-to-version/sqlserver.md)] |
| 15 | + |
| 16 | +This article teaches you how to see a summary of client connections to [!INCLUDE [ssazurearc](../../includes/ssazurearc.md)] by using the SQL Server Connections view in the Azure portal. |
| 17 | + |
| 18 | +> [!NOTE] |
| 19 | +> The SQL Server Connections view in the Azure portal is currently in preview. |
| 20 | +
|
| 21 | +## View SQL Server connections |
| 22 | + |
| 23 | +To view a summary of all client connections to the SQL Server instance, follow these steps: |
| 24 | + |
| 25 | +1. Select an instance of [!INCLUDE [ssazurearc](../../includes/ssazurearc.md)] in the [Azure portal](https://portal.azure.com). |
| 26 | +1. Under **Monitoring**, select **SQL Server Connections**. |
| 27 | +1. (Optionally) Use the time range to view connections during a preferred window within the last 30 days. |
| 28 | + |
| 29 | +Review the summarized data in the view: |
| 30 | + |
| 31 | +:::image type="content" source="media/sql-connection-summary/sql-connection-summary.png" alt-text="Screenshot of the SQL Client Connections view for SQL Server enabled by Azure Arc." lightbox="media/sql-connection-summary/sql-connection-summary.png"::: |
| 32 | + |
| 33 | +## How is the data collected? |
| 34 | + |
| 35 | +By default, the SQL Server Connections view is available to all SQL Server instances enabled by Azure Arc. Data collection starts as soon as the instance is connected to Azure. Azure Connected Machine agent automatically polls [sys.dm_exec_sessions](../../relational-databases/system-dynamic-management-views/sys-dm-exec-sessions-transact-sql.md) hourly. The portal displays the data collection time. The service maintains the data for 30 days. |
| 36 | + |
| 37 | +The connection data within the time range chosen on the portal dictates the client connection data summarized and presented as a table in the view. |
| 38 | + |
| 39 | +## Disable connections view |
| 40 | + |
| 41 | +Since the SQL Server connections view is enabled by default, you can choose to disable it and stop data collection. You can disable the SQL Server connections view by using the Azure portal, or the Azure CLI. |
| 42 | + |
| 43 | +### [Azure portal](#tab/azure-portal) |
| 44 | + |
| 45 | +To disable the SQL Server Connections view, follow these steps: |
| 46 | + |
| 47 | +1. On the **Overview** page for [!INCLUDE [ssazurearc](../../includes/ssazurearc.md)] in the [Azure portal](https://portal.azure.com), select **SQL Server Connections** to open the **SQL Server Connections** pane. |
| 48 | +1. On the **SQL Server Connections** pane, select **Disable** from the command bar. Select **Yes** on the **Disable SQL client connections** information box: |
| 49 | + |
| 50 | + :::image type="content" source="media/sql-connection-summary/sql-connection-disable.png" alt-text="Screenshot of disable option in SQL Client Connections view for SQL Server enabled by Azure Arc." lightbox="media/sql-connection-summary/sql-connection-disable.png"::: |
| 51 | + |
| 52 | +### [Azure CLI](#tab/azure-cli) |
| 53 | + |
| 54 | +To disable the SQL Server Connections view, replace placeholder values and then run the following Azure CLI command: |
| 55 | + |
| 56 | +```azurecli |
| 57 | +az sql server-arc extension feature-flag set --name ClientConnections --enable false --resource-group <resource_group>" --machine-name <server_name> |
| 58 | +``` |
| 59 | + |
| 60 | +--- |
| 61 | + |
| 62 | + |
| 63 | +## Enable connections view |
| 64 | + |
| 65 | +If SQL Server Connections view and data collection has been disabled, you can enable it again by using the Azure portal, or the Azure CLI. |
| 66 | + |
| 67 | +### [Azure portal](#tab/azure-portal) |
| 68 | + |
| 69 | +To disable the SQL Server Connections view, follow these steps: |
| 70 | + |
| 71 | +1. On the **Overview** pane for [!INCLUDE [ssazurearc](../../includes/ssazurearc.md)], select **SQL Server Connections** to open the **SQL Server Connections** page. |
| 72 | +1. On the **SQL Server Connections** pane, either select **Enable** from the command bar, or the **Enable Sql Connections** button to enable the SQL Server connections feature. |
| 73 | + |
| 74 | + :::image type="content" source="media/sql-connection-summary/sql-connection-enable.png" alt-text="Screenshot of enable option in SQL Client Connections view for SQL Server enabled by Azure Arc." lightbox="media/sql-connection-summary/sql-connection-enable.png"::: |
| 75 | + |
| 76 | +### [Azure CLI](#tab/azure-cli) |
| 77 | + |
| 78 | +To enable the SQL Server Connections view, replace placeholder values and then run the following Azure CLI command: |
| 79 | + |
| 80 | +```azurecli |
| 81 | +az sql server-arc extension feature-flag set --name ClientConnections --enable true --resource-group <resource_group>" --machine-name <server_name> |
| 82 | +``` |
| 83 | + |
| 84 | +--- |
| 85 | + |
| 86 | +## Related content |
| 87 | + |
| 88 | +- [Use performance dashboard to monitor SQL Server enabled by Azure Arc](sql-monitoring.md) |
| 89 | +- [System dynamic management views](../../relational-databases/system-dynamic-management-views/system-dynamic-management-views.md) |
0 commit comments