Déconnecter les instances SQL Server d’Azure Arc

S'applique à : SQL Server

Cet article décrit comment déconnecter les instances SQL Server d'Azure Arc en utilisant le portail Azure ou un shell de commande. Elle s'applique aux instances SQL Server activées par Azure Arc.

Prérequis

Votre compte Azure doit avoir un rôle Contributeur pour l’abonnement et le groupe de ressources de l’instance.

Remarque

Vous n’avez pas besoin d’accéder à la machine d’hébergement pour vous déconnecter d’Azure Arc.

Refuser l’installation automatique

Avant de désinstaller l’extension Azure pour SQL Server, refusez l'installation automatique de l'extension en ajoutant la balise et la valeur suivantes à la ressource SQL Server compatible avec Azure Arc :

Tag	Valeur
ArcSQLServerExtensionDeployment	Disabled

Vous pouvez également limiter les extensions qui peuvent être installées sur votre serveur. Vous pouvez configurer des listes des extensions dont vous souhaitez autoriser ou refuser l’installation sur le serveur. Pour plus d’informations, consultez Listes d’autorisation et listes de refus.

Désinstaller l’extension Azure pour SQL Server

Azure portal

Pour désinstaller l’extension Azure pour SQL Server :

1. Dans le portail Azure, accédez à Azure Arc.
2. Sous Machines, sélectionnez le serveur spécifique qui héberge l’instance SQL Server.
3. Sous Extensions, sélectionnez l’extension que vous souhaitez désinstaller (WindowsAgent.SqlServer sur Windows ou LinuxAgent.SqlServer sur Linux).
4. Sélectionner Désinstaller.
5. Lorsque vous y êtes invité, confirmez que vous souhaitez désinstaller l'extension.

Pour supprimer la ressource SQL Server - Azure Arc :

1. Dans le portail Azure, accédez à Azure Arc.
2. Sous instances des SQL Server, sélectionnez l’instance SQL Server que vous souhaitez supprimer.
3. Sélectionnez Supprimer.
4. Lorsque vous y êtes invité, confirmez que vous souhaitez supprimer la ressource.

PowerShell

Pour désinstaller l’extension Azure pour SQL Server, exécutez :

Remove-AzConnectedMachineExtension -MachineName "{your machine name}" -ResourceGroup "{your resource group name}" -Name "{extension name}" -NoWait

Sur Windows, le nom de l’extension est WindowsAgent.SqlServer. Sur Linux, le nom de l’extension est LinuxAgent.SqlServer.

Pour supprimer la ressource SQL Server - Azure Arc, exécutez :

remove-azresource -ResourceGroup "{your resource group name}" -ResourceType Microsoft.AzureArcData/SqlServerInstances -Name "{full SQL instance name}" -Force

Si votre instance (SQL Server – ressource Azure Arc) a des ressources Azure dépendantes, comme des bases de données (base de données SQL Server – ressource Azure Arc), cette commande peut prendre beaucoup de temps. Vous pouvez ajouter un paramètre -AsJob pour retourner immédiatement et exécuter la commande en tant que travail en arrière-plan.

Conseil

Exécutez le script à partir d’Azure Cloud Shell. Les modules Azure PowerShell requis y sont préinstallés et vous serez automatiquement authentifié. Pour plus d’informations, consultez Exécution du script à l’aide de Cloud Shell.

Azure CLI

Pour désinstaller l’extension Azure pour SQL Server, exécutez :

az connectedmachine extension delete --machine-name "{your machine name}" --resource-group "{your resource group name}" --name "{OS}Agent.SqlServer" --publisher "Microsoft.AzureData"

Pour supprimer la ressource SQL Server - Azure Arc, exécutez :

az resource delete --resource-group "{your resource group name}" --resource-type Microsoft.AzureArcData/SqlServerInstances --name "{full SQL instance name}"

Si votre instance (SQL Server - ressource Azure Arc) dispose de ressources Azure dépendantes, telles que des bases de données SQL Server, cette commande peut prendre beaucoup de temps à se terminer. Vous pouvez ajouter le paramètre --No-Wait pour retourner immédiatement et exécuter la commande en tant que travail en arrière-plan.

Pour déconnecter toutes les instances SQL Server compatibles avec Azure Arc dans un périmètre plus large (tel qu'un groupe de ressources, un abonnement ou plusieurs abonnements) en une seule commande, utilisez le script de désinstallation d'Azure Extension for SQL Server. Le script sert d’exemple SQL Server open source et comprend des instructions étape par étape.

Fichiers et comptes résiduels

Après avoir désinstallé l’extension Azure pour SQL Server, certains fichiers et objets de base de données restent.

Fichiers

La désinstallation de l’extension supprime les fichiers binaires, mais les journaux d’activité d’extension et d’autres données peuvent ne pas être supprimés.

La désactivation de l’extension ne supprime aucun fichier ou dossier binaire.

Tables

Les tables créées par l'agent sont conservées après la désinstallation de l'extension.

Comptes

Si vous n’avez pas installé l’extension en mode privilège minimum, l’agent utilise le compte NTAUTHORITY\SYSTEM.

La désactivation ou la suppression de l’extension ne supprime pas la connexion NTAUTHORITY\SYSTEM des bases de données, car d’autres applications peuvent nécessiter cette connexion. Vous devez supprimer manuellement le rôle de chaque base de données utilisateur.

Un compte NTAUTHORITY\SYSTEM ne s’applique pas aux installations qui utilisent des privilèges minimum.

Pour des détails sur le mode privilège minimum, consultez Utiliser SQL Server activé par Azure Arc avec des privilèges minimum.