Administrar la conexión automática para SQL Server habilitado por Azure Arc

Se aplica a:SQL Server

Las instancias de SQL Server se conectan automáticamente a Azure Arc cuando se instalan en un servidor habilitado para Azure Arc y el recurso del servidor arc se encuentra en una región admitida. Todos los recursos de instancia de SQL Server se crean automáticamente en Azure, lo que proporciona una plataforma de administración centralizada para todas las instancias de SQL Server. Para más información, visite SQL Server habilitado por Azure Arc.

En este artículo se detalla cómo funciona el proceso simplificado de conexión de SQL Server a Azure.

Requisitos previos

1. Complete los requisitos previos: SQL Server habilitado por Azure Arc.
2. En el caso de los grupos de disponibilidad Always On, complete los pasos en todos los nodos.

Especificación del tipo de licencia

Opcionalmente, especifique el tipo de licencia para cada instancia de SQL Server.

Para especificar el tipo de licencia deseado, proporcione la etiqueta de valor de tipo de licencia. El flujo de trabajo de conexión automática requiere esa etiqueta. Para obtener más información, consulte Uso de etiquetas para organizar los recursos de Azure y la jerarquía de administración.

Puede establecer valores de etiqueta en el nivel de suscripción, grupo de recursos o recurso. Los valores de etiqueta establecidos en el nivel de suscripción reemplazan los valores establecidos en el grupo de recursos y en el nivel de recurso. Los valores de etiqueta establecidos en el nivel de grupo de recursos reemplazan los valores establecidos en el nivel de recurso.

Añada uno de los valores y etiquetas siguientes a una suscripción, grupos de recursos o recursos de Arc Server.

Establecimiento de la precedencia del tipo de licencia

Instalación automática de la extensión de Azure para SQL Server en servidores nuevos conectados a Arc

Microsoft instala automáticamente la extensión de Azure para SQL Server en cada servidor habilitado para Arc conectado a Azure Arc si tiene alguna instancia de SQL Server instalada. Este proceso automatizado implica las siguientes tareas:

1. Registro del proveedor de recursos de Microsoft.AzureArcData, si aún no está registrado.

2. Configuración del tipo de licencia.

3. Instalación de la extensión de Azure para SQL Server.

   Nota

   Se establece el tipo de licencia si se establece el valor de la etiqueta ArcSQLServerExtensionDeployment.

4. Creación de un recurso de instancia de SQL Server habilitado para Arc en Azure.

Para conectar AUTOMÁTICAMENTE SQL Server habilitado por Azure Arc, use uno de los métodos proporcionados que cumplan los requisitos Opciones de implementación de SQL Server habilitados por Azure Arc.

Una vez completada la conexión, puede beneficiarse de las características de Azure para SQL Server. Para más información, visite Configuración de SQL Server habilitado por Azure Arc.

Compruebe y corrija la configuración de licencias

Para comprobar la configuración del tipo de licencia creada por el proceso de incorporación, ejecute esta consulta de Resource Graph.

resources
| where type == "microsoft.hybridcompute/machines"
| extend
    joinID = toupper(id)
| join kind = inner (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | extend machineId = toupper(substring(id, 0, indexof(id, '/extensions')))
    | where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
    | extend licenseType = iff(properties.settings.LicenseType == '', 'Configuration needed', properties.settings.LicenseType)
    | project  machineId, licenseType
) on $left.joinID == $right.machineId
| project id, licenseType

El valor Configuration needed indica que el proceso de incorporación no tenía suficiente información para configurar el tipo de licencia automáticamente. Para más información sobre cómo establecer el valor que falta o cambiar un valor configurado automáticamente, visite Configuración de SQL Server habilitado por Azure Arc.

Cancelar la conexión automática

Si deseas cancelar la instalación automática de la extensión de Azure para SQL Server, agrega la etiqueta y el valor siguientes a una suscripción, grupos de recursos o recursos de Arc Server. Si ya hay servidores habilitados para Arc existentes en la suscripción o el grupo de recursos, puede tardar hasta 8 horas en que los cambios en el valor de etiqueta surtan efecto, ya que el valor de etiqueta se almacena en caché.

Como alternativa, puede limitar qué extensiones se pueden instalar en el servidor. Puede configurar listas de las extensiones que quiere permitir y bloquear en el servidor. Para más información, consulte Listas de permitidos y listas de bloqueados de extensiones.

Obtenga información sobre cómo Microsoft instala automáticamente la extensión de Azure para SQL Server

Microsoft puede ejecutar instalaciones de extensión en un servidor habilitado para Arc mediante el servicio de extensión de configuración de invitado del servicio de Windows (ExtensionService). Cuando el servidor está conectado a Arc, se instala el servicio de extensión de configuración de invitado de servicio de Windows (ExtensionService). Este servicio se encarga de la instalación, actualización y eliminación de extensiones (agentes, scripts u otro software) en el equipo. Los servicios de la extensión y configuración de invitados se ejecutan como sistema local en Windows y como raíz en Linux. Para más información sobre los servicios del agente de Arc y las cuentas de servicio, consulte Seguridad y permisos del agente

Microsoft puede llamar a las API para implementar la extensión de Azure para SQL Server y conectarse automáticamente a SQL Server habilitado para Arc.

También puede instalar las extensiones mediante las API de Azure Portal, las API de Azure Resource Manager (ARM), Azure Policy, las plantillas de ARM, la CLI de Azure o el módulo de Azure PowerShell. Opciones de implementación de SQL Server habilitado por Azure Arc

Busca instancias de SQL Server conectadas a Arc, pero falta la extensión de Azure para SQL Server

Usa la consulta de Azure Graph siguiente para enumerar los Id. de máquina y suscripción que contienen servidores de Arc con SQL Server instalados pero a los que les faltan extensiones de Azure para SQL Server.

resources
| where type == "microsoft.hybridcompute/machines" and properties['detectedProperties']['mssqldiscovered'] has "true"
| extend
    joinID = toupper(id)
| join kind= inner  (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | extend machineId = toupper(substring(id, 0, indexof(id, '/extensions')))
    | project machineId, name
    | summarize allExtensions = make_list(name) by machineId
    | where allExtensions !has ("SqlServer")
) on $left.joinID == $right.machineId
| project id, subscriptionId, tenantId

Actualización de la extensión

Para determinar la versión actual de la extensión, revise las notas de lanzamiento.

Para comprobar la versión de la extensión, use el siguiente comando de PowerShell:

azcmagent version

Para simplificar las actualizaciones de extensiones, asegúrese de habilitar las actualizaciones automáticas. También puede actualizar manualmente la extensión mediante Azure Portal, PowerShell y la CLI de Azure.

Install-Module -Name Az.ConnectedMachine

# Variables 
$Subscription_Id = "<SubscriptionId>" 
$ResourceGroup = "<ResourceGroup>" 
$MachineName = "<MachineName>" 
$ExtensionName = "WindowsAgent.SqlServer" 
$Publisher = "Microsoft.AzureData" 
$TargetVersion = "<LatestVersion>"  # Example: 1.1.3211.337 

# Upgrade the extension 
Set-AzContext -Subscription $SubscriptionId 

$params = @{
  ResourceGroupName = $ResourceGroup
  MachineName = $MachineName
  Name = $ExtensionName
  Publisher = $Publisher
  Type = $ExtensionName
  TypeHandlerVersion = $TargetVersion
}

Update-AzConnectedMachineExtension @params

az extension add --name connectedmachine 

# Variables 
Subscription_Id="<SubscriptionId>" 
Resource_Group="<ResourceGroup>" 
Machine_Name="<ArcEnabledServerName>" 
Extension_Name="WindowsAgent.SqlServer" 
Publisher="Microsoft.AzureData" 
Target_Version="<LatestVersion>"  # Example: 1.1.3211.337 

# Upgrade the extension 

az account set --subscription $Subscription_Id 
az connectedmachine extension update \ 
    --resource-group $Resource_Group \ 
    --machine-name $Machine_Name \ 
    --name $Extension_Name \ 
    --publisher $Publisher \ 
    --type $Extension_Name \ 
    --type-handler-version $Target_Version 

Para más información sobre cómo actualizar la extensión de Azure para SQL Server, consulte Actualización de la extensión.

Contenido relacionado

• Configuración de la evaluación de procedimientos recomendados para SQL Server habilitado por Azure Arc
• Administración del inventario de recursos de SQL Server con Azure Arc
• Configurar SQL Server habilitado por Azure Arc
• Uso de los registros de actividad con SQL Server habilitado por Azure Arc
• Recopilación de datos y elaboración de informes de SQL Server habilitado por Azure Arc