Lokasi ngalangkungan proxy:   [ UP ]  
[Ngawartoskeun bug]   [Panyetelan cookie]                
Skip to content

Commit 3916542

Browse files
authored
Merge pull request #23132 from pochiraju/patch-1
Update connect.md
2 parents 9bbb917 + b89194e commit 3916542

1 file changed

Lines changed: 18 additions & 12 deletions

File tree

docs/sql-server/azure-arc/connect.md

Lines changed: 18 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.prod: sql
1313
---
1414
# Connect your SQL Server to Azure Arc
1515

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).
1717

1818
You can connect your SQL Server instance to Azure Arc by following these steps.
1919

@@ -50,7 +50,7 @@ az provider register --namespace 'Microsoft.AzureArcData'
5050

5151
## Initiate the connection from Azure
5252

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.
5454

5555
> [!IMPORTANT]
5656
>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:
7272

7373
1. Open the __Server - Azure Arc__ resource.
7474
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__.
7676

7777
# [PowerShell](#tab/powershell)
7878

@@ -99,25 +99,31 @@ spID=$(az resource list -n <ArcMachineName> --query [*].identity.principalId --o
9999
az role assignment create --assignee $spID --role 'Azure Connected SQL Server Onboarding' --scope /subscriptions/<mySubscriptionID>/resourceGroups/<myResourceGroup>
100100
```
101101

102-
To install the SQL Server extension, run:
102+
To install the SQL Server Extension - Azure Arc for Windows Operating System, run:
103103

104104
```azurecli
105105
az connectedmachine extension create --machine-name "{your machine name}" --location "{azure region}" --name "WindowsAgent.SqlServer" --resource-group "{your resource group name}" --type "WindowsAgent.SqlServer" --publisher "Microsoft.AzureData" --settings '{\"SqlManagement\":{\"IsEnabled\":true}, \"excludedSqlInstances\":[]}'
106106
```
107107

108108
---
109109

110+
To install the SQL Server Extension - Azure Arc for Linux Operating System, run:
111+
112+
```azurecli
113+
az connectedmachine extension create --machine-name "{your machine name}" --location "{azure region}" --name "LinuxAgent.SqlServer" --resource-group "{your resource group name}" --type "LinuxAgent.SqlServer" --publisher "Microsoft.AzureData" --settings '{\"SqlManagement\":{\"IsEnabled\":true}, \"excludedSqlInstances\":[]}'
114+
```
115+
116+
---
117+
110118
> [!NOTE]
111119
> The specified resource group must match the resource group of the corresponding __Server - Azure Arc__ resource. Otherwise, the command will fail.
112120
113121
## Initiate the connection from the target machine
114122

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".
116124

117125
### Generate a onboarding script for SQL Server
118126

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-
121127
1. Search for __SQL Server - Azure Arc__ resource type and add a new one through the creation blade.
122128
![Start creation](media/join/start-creation-of-sql-server-azure-arc-resource.png)
123129

@@ -173,20 +179,20 @@ Go [Azure portal](https://ms.portal.azure.com/#home) and open the newly register
173179

174180
![Validate connected SQL server ](media/join/validate-sql-server-azure-arc.png)
175181

176-
## Disconnect your SQL Server instance
182+
## Delete your SQL Server - Azure Arc resource
177183

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.
179185

180186
![Unregister SQL Server](media/join/unregister-sql-server-azure-arc.png)
181187

182188
> [!IMPORTANT]
183-
> 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.
184190
185191
## Restore a deleted SQL Server - Azure Arc resource
186192

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.
188194

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.
190196

191197
```azurecli
192198
az connectedmachine extension create --machine-name "{your machine name}" --location "{azure region}" --name "WindowsAgent.SqlServer" --resource-group "{your resource group name}" --type "WindowsAgent.SqlServer" --publisher "Microsoft.AzureData" --settings '{\"SqlManagement\":{\"IsEnabled\":true}, \"excludedSqlInstances\":[]}'

0 commit comments

Comments
 (0)