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: docs/sql-server/azure-arc/connect.md
+18-12Lines changed: 18 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ ms.prod: sql
13
13
---
14
14
# Connect your SQL Server to Azure Arc
15
15
16
-
Beginning in SQL Server 2022 (Preview), you can deploy an instance of SQL Server from the command prompt that is connected to Azure Arc. See [Deploy - connected to Azure Arc](../../database-engine/install-windows/install-sql-server-from-the-command-prompt.md#deploy---connected-to-azure-arc).
16
+
Beginning with SQL Server 2022 (preview) you can install the Azure Arc agent with the SQL Server extension when you are installing SQL Server on Windows Operating System. See [Deploy - connected to Azure Arc](../../database-engine/install-windows/install-sql-server-from-the-command-prompt.md#deploy---connected-to-azure-arc).
17
17
18
18
You can connect your SQL Server instance to Azure Arc by following these steps.
19
19
@@ -50,7 +50,7 @@ az provider register --namespace 'Microsoft.AzureArcData'
50
50
51
51
## Initiate the connection from Azure
52
52
53
-
If the machine with SQL Server is already connected to Azure Arc, you can register the SQL Server instances on that machine by installing the SQL Server extension (*WindowsAgent.SqlServer*). Once installed, the SQL Server extension will recognize all the installed SQL Server instances and register them with Azure Arc. The extension will run continuously to detect changes of the SQL Server configuration. For example, if a new SQL Server instance is installed on the machine, if will be automatically registered with Azure. See [virtual machine extension management](/azure/azure-arc/servers/manage-vm-extensions) for instructions on how to install and uninstall extensions using the Azure portal, Azure PowerShell or Azure CLI.
53
+
If the machine with SQL Server is already connected to Azure Arc, you can register the SQL Server instances on that machine by installing the SQL Server extension, "*SQL Server Extension - Azure Arc*". Once installed, the SQL Server extension will recognize all the installed SQL Server instances and register them with Azure Arc. The extension will run continuously to detect changes of the SQL Server configuration. For example, if a new SQL Server instance is installed on the machine, it will be automatically registered with Azure. See [virtual machine extension management](/azure/azure-arc/servers/manage-vm-extensions) for instructions on how to install and uninstall extensions using the Azure portal, Azure PowerShell or Azure CLI.
54
54
55
55
> [!IMPORTANT]
56
56
>1. The Managed System Identity for the corresponding **Server - Azure Arc** must have the *Azure Connected SQL Server Onboarding* role at resource group level.
@@ -72,7 +72,7 @@ To install the SQL Server extension, use the following steps:
72
72
73
73
1. Open the __Server - Azure Arc__ resource.
74
74
2. Under __Extensions__, click __+ Add__
75
-
1. Select `WindowsAgent.SqlServer` from the list and click __Create__.
75
+
1. Select `SQL Server Extension - Azure Arc` from the list and click __Create__.
az role assignment create --assignee $spID --role 'Azure Connected SQL Server Onboarding' --scope /subscriptions/<mySubscriptionID>/resourceGroups/<myResourceGroup>
100
100
```
101
101
102
-
To install the SQL Server extension, run:
102
+
To install the SQL Server Extension - Azure Arc for Windows Operating System, run:
> The specified resource group must match the resource group of the corresponding __Server - Azure Arc__ resource. Otherwise, the command will fail.
112
120
113
121
## Initiate the connection from the target machine
114
122
115
-
If you want to customize the process of connecting the SQL Server instance to Azure Arc, you can initiate the connection from the target machine using the onboarding script.
123
+
If the server is not an Arc-Server enabled yet, you can initiate the connection from the target machine using the onboarding script. This script onboard the server to Arc-Server and as well as install "SQL Server Extension - Azure Arc".
116
124
117
125
### Generate a onboarding script for SQL Server
118
126
119
-
If the machine with SQL Server is already connected to Azure Arc, you can register the SQL Server instances on that machine by installing the SQL Server extension (*WindowsAgent.SqlServer*). Once installed, the SQL Server extension will recognize all the installed SQL Server instances and register them with Azure Arc. The extension will run continuously to detect changes of the SQL Server configuration. For example, if a new SQL Server instance is installed on the machine, the extension automatically registers it with Azure. See [virtual machine extension management](/azure/azure-arc/servers/manage-vm-extensions) for instructions how to install and uninstall extensions using Azure portal, Azure PowerShell, or Azure CLI.
120
-
121
127
1. Search for __SQL Server - Azure Arc__ resource type and add a new one through the creation blade.
@@ -173,20 +179,20 @@ Go [Azure portal](https://ms.portal.azure.com/#home) and open the newly register
173
179
174
180

175
181
176
-
## Disconnect your SQL Server instance
182
+
## Delete your SQL Server - Azure Arc resource
177
183
178
-
To disconnect your SQL Server instance from Azure Arc, go to Azure portal, open the __SQL Server - Azure Arc__ resource for that instance, and click the **Unregister** button. It will delete this resource and instruct the SQL Server extension on the machine to stop monitoring this SQL Server instance.
184
+
To delete your SQL Server instance from Azure Arc, go to Azure portal, open the __SQL Server - Azure Arc__ resource for that instance, and select the **Delete** button. It will delete this resource and instruct the SQL Server extension on the machine to stop monitoring this SQL Server instance.
> Because there could be multiple SQL Server instances installed on the same machine, the *Unregister* button will not uninstall the SQL Server extension. To uninstall it, follow the [uninstall extension](/azure/azure-arc/servers/manage-vm-extensions-portal#uninstall-extension) steps.
189
+
> Because there could be multiple SQL Server instances installed on the same machine, the *Delete* button will not uninstall the SQL Server extension. To uninstall it, follow the [uninstall extension](/azure/azure-arc/servers/manage-vm-extensions-portal#uninstall-extension) steps.
184
190
185
191
## Restore a deleted SQL Server - Azure Arc resource
186
192
187
-
If you disconnected your SQL Server instance by mistake, you can restore its __SQL Server - Azure Arc__ resource with the following steps.
193
+
If you deleted your SQL Server instance by mistake, you can restore its __SQL Server - Azure Arc__ resource with the following steps.
188
194
189
-
1. If you also uninstalled the SQL Server extension by mistake, reinstall it.
195
+
1. If you also uninstalled the SQL Server extension by mistake, reinstall it. Please make sure to replace "WindowsAgent.SqlServer" with "LinuxAgent.SqlServer" for SQL Servers running on Linux Operating system in the commands below.
0 commit comments