title | description | author | ms.author | ms.reviewer | ms.date | ms.topic | ms.custom |
---|---|---|---|---|---|---|---|
Prerequisites |
Describes prerequisites required for SQL Server enabled by Azure Arc. |
anosov1960 |
sashan |
mikeray, randolphwest |
01/24/2024 |
conceptual |
references_regions |
[!INCLUDE sqlserver]
An Azure Arc-enabled instance of [!INCLUDE ssnoversion-md] is an instance on-premises or in a cloud provider that is connected to Azure Arc. This article explains those prerequisites.
If your SQL Server VMs are on VMware clusters, review Support on VMware.
Before you can Arc-enable an instance of [!INCLUDE ssnoversion-md], you need to:
-
Have an Azure account with an active subscription. If needed, create a free Azure Account.
-
Verify Arc connected machine agent prerequisites. The Arc agent must be running in the typical 'full' mode.
-
Open firewall to Azure Arc data processing service.
-
Register resource providers. Specifically:
Microsoft.AzureArcData
Microsoft.HybridCompute
For instructions, see Register resource providers.
The user or service principal requires:
- Read permission on the subscription
- Local administrator permission on the operating system to install and configure the agent
- For Linux, use the root account
- For Windows, use an account that is a member of the Local Administrators group
Before enabling SQL Servers with Arc, the installation script checks:
- The region where the Arc-enabled SQL Server is supported
Microsoft.AzureArcData
resource provider is registered
These checks require read permission on the subscription for the user.
The user or service principal requires the following permissions in the Azure resource group to complete the task. Specifically:
Azure Connected Machine Onboarding
roleMicrosoft.AzureArcData/register/action
Microsoft.HybridCompute/machines/extensions/read
Microsoft.HybridCompute/machines/extensions/write
Microsoft.Resources/deployments/validate/action
Users can be assigned to built-in roles that have these permissions, for example:
For more information, see Assign Azure roles using the Azure portal.
The SQL Server service account must be a member of the sysadmin fixed server role on each SQL Server instance.
Note
The exclusion in this section is required for the March, 2024 release and before.
Beginning with the release in April, 2024 this exclusion is not required.
If a proxy server is used, set the NO_PROXY
environment variable to exclude proxy traffic for:
localhost
127.0.0.1
[!INCLUDE data-processing-service-permission]
Note
You can't use Azure Private Link connections to the Azure Arc data processing service. See Unsupported configurations.
[!INCLUDE supported-configurations]
[!INCLUDE unsupported-configurations]
To register the resource providers, use one of the following methods:
- Select Subscriptions.
- Choose your subscription.
- Under Settings, select Resource providers.
- Search for
Microsoft.AzureArcData
andMicrosoft.HybridCompute
and select Register.
Run:
Register-AzResourceProvider -ProviderNamespace Microsoft.HybridCompute
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureArcData
Run:
az provider register --namespace 'Microsoft.HybridCompute'
az provider register --namespace 'Microsoft.AzureArcData'
Before configuring your [!INCLUDE ssnoversion-md] instances and machines with Azure Arc, review the Azure Resource Manager subscription limits and resource group limits to plan for the number of machines to be connected.
[!INCLUDE azure-arc-data-regions]
The [!INCLUDE sssql22-md] Setup Installation Wizard doesn't support installation of the Azure extension for SQL Server. There are two ways to install this component. Do one of the following:
- Automatically connect your SQL Server to Azure Arc
- Install Azure extension for SQL Server from the command line
For VMware clusters, review Support on VMware.