Partager via


Problèmes connus et résolution des problèmes liés à l’extension Agent IaaS SQL Server

S’applique à : SQL Server sur la machine virtuelle Azure

Cet article vous aide à résoudre les problèmes connus et les erreurs lors de l’utilisation de l’extension Agent IaaS SQL Server.

Pour obtenir des réponses aux questions fréquemment posées sur l’extension, consultez les Questions fréquentes (FAQ).

Vérifier les conditions préalables

Pour éviter les erreurs dues à des options non prises en charge ou à des limitations, vérifiez les prérequis pour l’extension.

Si vous réparez ou que vous réinstallez l’extension Agent IaaS SQL, votre paramètre ne sera pas conservé, sauf les changements de licence. Si vous avez réparé ou réinstallé l’extension, vous devez reconfigurer la sauvegarde automatisée, la mise à jour corrective automatisée et tous les autres services que vous avez configurés avant la réparation ou la réinstallation.

Vérifier l’intégrité de l’extension

Vous pouvez vérifier l’intégrité de votre extension dans la page Vue d’ensemble de votre ressource de machines virtuelles SQL dans le portail Azure, dans l’état d’intégrité de l’extension.

Capture d’écran du portail Azure, volet Vue d’ensemble de la ressource Machines virtuelles SQL.

Remarque

Vous pouvez utiliser un script PowerShell pour vérifier l’état d’intégrité de l’extension sur vos machines virtuelles. Vous trouverez le script complet sur GitHub. Veuillez consulter la rubrique Obtenir l’état d’intégrité de l’extension SQL IaaS Agent avec Az PowerShell.

L’état de l’extension SQL IaaS Agent peut être :

  • Sain : tout fonctionne comme prévu.
  • Échec : le service sql IaaS Agent principal n’est pas en cours d’exécution sur la machine virtuelle SQL Server.
  • Défectueux : un ou plusieurs sous-services ont un problème.

Si l’état de l’extension SQL IaaS Agent n’est défectueux ou a échoué, allez dans les notifications sur la page Vue d’ensemble pour en savoir plus.

Réparer l’extension

Il est possible que votre extension de l’agent IaaS SQL soit dans un état d’échec. Utilisez le portail Azure pour réparer l’extension de l’agent IaaS SQL.

Pour réparer l’extension avec le Portail Azure :

  1. Connectez-vous au portail Azure.

  2. Accédez à votre ressource machines virtuelles SQL.

  3. Sélectionnez votre machine virtuelle SQL Server dans la liste. Si votre machine virtuelle SQL Server n’est pas listée ici, il est probable qu’elle n’a pas été inscrite auprès de l’extension SQL IaaS Agent.

  4. Sélectionnez Paramètres de l’extension SQL IaaS Agent sous Aide.

  5. Si votre état de provisionnement indique Échec, sélectionnez Réparer pour réparer l’extension. Si votre état est Réussite, vous pouvez cocher la case en regard de Forcer la réparation pour réparer l’extension, quel que soit l’état.

    Capture d’écran de la page des paramètres de l’extension SQL IaaS Agent de l’extension de machines virtuelles SQL dans le portail Azure montrant où réparer l’extension.

Le service d'extension principal n’est pas en cours d’exécution

Le service principal d’extension SQL IaaS Agent (Agent IaaS Microsoft SQL Server) est dans un état d’arrêt. L’état de l’extension SQL IaaS Agent a échoué en raison de cette erreur.

Pour résoudre ce problème, réparez l’extension.

Le service de requête d’extension n’est pas en cours d’exécution

L’extension SQL IaaS Agent utilise le service de requête (Service de requête IaaS Microsoft SQL Server) pour communiquer avec SQL Server. Si le service de requête est dans un état d’arrêt, les fonctionnalités qui s’appuient sur la communication avec SQL Server ne fonctionnent pas. L’état de l’extension SQL IaaS Agent est défectueux en raison de cette erreur.

Pour résoudre ce problème, réparez l’extension.

SQL Server n'est pas en cours d’exécution.

Le service SQL Server est à l’arrêt. L’état de l’extension SQL IaaS Agent est défectueux en raison de cette erreur.

Examinez plus en détail et redémarrez le service.

L’extension ne dispose pas des autorisations correctes

Le service de requête d’extension SQL IaaS Agent (Service de requête IaaS Microsoft SQL Server) utilise le NT Service\SQLIaaSExtensionQuery compte pour interroger l’instance SQL Server. Si cette connexion est supprimée de SQL Server ou si une stratégie d’utilisateur ou de domaine modifie les autorisations pour la connexion, vous verrez l’erreur indiquant que l’extension n’a pas les autorisations appropriées. L’état de l’extension SQL IaaS Agent est défectueux en raison de cette erreur.

Pour les machines virtuelles SQL Server qui utilisent le modèle d’autorisations de privilège minimum, vérifiez pour vous assurer que le compte NT Service\SQLIaaSExtensionQuery dispose des autorisations appropriées associées à chaque fonctionnalité activée. Si aucune fonctionnalité n’est activée, l’erreur s’affiche si la connexion NT Service\SQLIaaSExtensionQuery n’existe pas dans SQL Server ou si le service de requête IaaS Microsoft SQL Server s’exécute sous un nom d’utilisateur différent de NT Service\SQLIaaSExtensionQuery.

Certaines machines virtuelles SQL Server déployées avant octobre 2022 peuvent toujours utiliser un modèle d’autorisations administrateur système plus ancien. Pour ces machines virtuelles plus anciennes, vous verrez l’erreur d’autorisations si la NT Service\SQLIaaSExtensionQuery n’existe pas ou n’a pas de droits d’administrateur système dans SQL Server, ou si le service de requête IaaS Microsoft SQL Server s’exécute sous un nom d’utilisateur différent de NT Service\SQLIaaSExtensionQuery.

Pour résoudre cette condition d’erreur, vérifiez que la connexion existe dans SQL Server et qu’elle dispose des autorisations appropriées en fonction des fonctionnalités que vous avez activées. Vous devrez peut-être recréer la connexion et/ou attribuer des autorisations correctes. Par ailleurs, assurez-vous que le service de requête IaaS Microsoft SQL Server s’exécute sous le nom d’utilisateur NT Service\SQLIaaSExtensionQuery.

Erreur « l'image n'est pas prise en charge »

L’inscription de l’extension SQL IaaS Agent est bloquée sur les images Place de marché Azure non prises en charge suivantes :

  • Machine virtuelle Power BI
  • SQL Server Analysis Services

État non valide pour la gestion

Réparez l’extension si le message d’erreur suivant s’affiche :

The SQL virtual machines resource is not in a valid state for management

La machine virtuelle sous-jacente est non valide

Si le message d’erreur suivant s’affiche :

SQL management operations are disabled because the state of underlying virtual machine is invalid

Tenez compte des éléments suivants :

  • La machine virtuelle SQL peut être arrêtée, désallouée, dans un état d’échec ou introuvable. Vérifiez que la machine virtuelle sous-jacente est en cours d’exécution.
  • Votre extension d’agent IaaS SQL peut être dans un état d’échec. Réparez l’extension.

Supprimez l’extension de votre machine virtuelle SQL, puis réinscrivez la machine virtuelle SQL auprès de l’extension si vous avez effectué une des opérations suivantes :

  • Vous avez migré votre machine virtuelle d’un abonnement à l’autre.
  • Vous avez modifié les paramètres régionaux ou le classement de SQL Server.
  • Vous avez changé la version de votre instance SQL Server.
  • Vous avez changé l’édition de votre instance SQL Server.

Échec de l’approvisionnement

Réparez l’extension si l’état de l’extension d’agent IaaS SQL est Échec du provisionnement dans le portail Azure.

L’extension Agent IaaS SQL peut échouer si TCP/IP est désactivé dans le Gestionnaire de configuration SQL Server ou au niveau de la machine virtuelle.

Ressource de machine virtuelle SQL indisponible dans le portail

Si l’extension d’agent IaaS SQL est installée et que la machine virtuelle est en ligne, mais que la ressource de machine virtuelle SQL n’est pas disponible dans le portail Azure, vérifiez que vos services SQL Server et SQL Browser sont démarrés dans la machine virtuelle. Si cela ne résout pas le problème, réparez l’extension.

Les fonctionnalités sont en grisé

Si vous accédez à votre ressource de machine virtuelle SQL dans le portail Azure et que certaines fonctionnalités sont en grisé, vérifiez que la machine virtuelle SQL est en cours d’exécution et que vous disposez de la dernière version de l’extension d’agent IaaS SQL.

Compte de service modifié

Le changement des comptes de service pour un des deux services associés à l’extension peut entraîner l’échec ou le comportement imprévisible de l’extension.

Les deux services doivent s’exécuter sous les comptes suivants :

  • Agent IaaS Microsoft SQL Server est le service principal de l’extension Agent IaaS SQL et il doit s’exécuter sous le compte Système local.
  • Service de requête IaaS Microsoft SQL Server est un service d’assistance qui aide l’extension à exécuter des requêtes dans SQL Server et il doit s’exécuter sous le compte Service NTNT Service\SqlIaaSExtensionQuery.

Échec de l’inscription automatique

Si vous avez quelques machines virtuelles SQL Server qui ont échoué à s’inscrire automatiquement, vérifiez la version de SQL Server sur les machines virtuelles qui ont échoué à s’inscrire. Par défaut, les machines virtuelles Azure avec SQL Server 2016 ou ultérieur sont inscrites automatiquement auprès de l’extension Agent IaaS SQL quand elles sont détectées par le service CEIP. Les machines virtuelles SQL Server qui ont des versions antérieures à 2016 doivent être inscrites manuellement individuellement ou en bloc.

Consommation élevée de ressources

Si vous remarquez que l’extension Agent IaaS SQL consomme de façon inattendue une quantité élevée de processeur ou de mémoire, vérifiez que vous disposez de la version la plus récente de l’extension. Si c’est le cas, redémarrez Agent IaaS Microsoft SQL Server à partir de services.msc.

Impossible d’étendre les disques

L’extension de vos disques à partir de la page Configuration du stockage de la ressource de machine virtuelle SQL n’est pas disponible dans les conditions suivantes :

  • Si vous désinstallez, puis que vous réinstallez l’extension Agent IaaS SQL.
  • Si vous désinstallez, puis que vous réinstallez votre instance de SQL Server.
  • Si vous avez utilisé des conventions de nommage personnalisées pour le nom du disque/pool de stockage lors du déploiement de votre image SQL Server à partir de la Place de marché Azure.
  • Si vous avez déployé votre machine virtuelle SQL Server avec Premium SSDv2.
  • Si TCP/IP est désactivé dans le Gestionnaire de configuration SQL Server ou au niveau de la machine virtuelle.

Configuration du disque en grisé pendant le déploiement

Si vous créez votre machine virtuelle SQL Server en utilisant un disque non managé, la configuration du disque est en grisé par conception.

Sauvegarde automatisée désactivée

Si votre ressource de machine virtuelle SQL affiche La sauvegarde automatisée est actuellement désactivée, vérifiez si les sauvegardes managées de votre instance SQL Server sont activées. Pour utiliser les sauvegardes automatisées à partir du portail Azure, désactivez les sauvegardes managées dans SQL Server.

Extension bloquée en transition

Votre extension Agent IaaS SQL peut être bloquée dans un état de transition dans les scénarios suivants :

  • Vous avez supprimé le service NT service\SQLIaaSExtension des connexions SQL Server et/ou du groupe de l’administrateur local.
  • Un de ces deux services est arrêté dans services.msc
    • Agent IaaS Microsoft SQL
    • Service de requête IaaS Microsoft SQL Server

Échec de l’installation sur le contrôleur de domaine

L’inscription de votre instance SQL Server installée sur votre contrôleur de domaine auprès l’extension Agent IaaS SQL n’est pas prise en charge. L’inscription auprès de l’extension crée l’utilisateur NT Service\SQLIaaSExtension. Comme cet utilisateur ne peut pas être créé sur le contrôleur de domaine, l’inscription de cette machine virtuelle auprès de SQL IaaS Agent n’est pas prise en charge.

TCP/IP est désactivé

L’extension Agent SQL nécessite que TCP/IP soit activé à la fois dans le Gestionnaire de configuration SQL Server et au niveau de la machine virtuelle. La désactivation du protocole TCP/IP peut entraîner un comportement imprévisible, comme l’échec de l’installation ou de certaines fonctionnalités.

Impossible de trouver l’instance SQL à cibler

Erreur : Unable to find SQL instance to target. Skipping 'NT Service\\SQLIaaSExtensionQuery' removal from SQL logins est un message d’avertissement qui peut être ignoré en toute sécurité.

Vous pouvez voir ce message dans l'observateur d'événements Windows si votre abonnement possède l’enregistrement automatiquement mais que votre machine virtuelle Azure n'a pas installé SQL Server, auquel cas vous pouvez ignorer ce message.

Le service MSSQLSERVER n’a pas été trouvé sur l’ordinateur

Erreur : SQL Server IaaS Agent: PreReq failure: ErrorCode: NotRetryableUnexpectedError, Message: Service MSSQLSERVER was not found on computer '.'.;The specified service does not exist as an installed service

L’extension SQL IaaS Agent fonctionne seulement avec une instance par défaut ou une instance nommée. Pour plus d’informations, consultez Prise en charge de plusieurs instances.

Le service portant le nom « MSSQLSERVER » n’est pas en cours d’exécution

Erreur : Service with name 'MSSQLSERVER' is not running. Please make sure service 'MSSQLSERVER' is running and retry this operation

Vérifiez si le service SQL Server pour l’instance par défaut est en cours d’exécution à l’intérieur de la machine virtuelle, autrement réparez l’extension IaaS. Si vous avez plusieurs instances SQL Server, l’extension SQL IaaS Agent ne fonctionnera pas car plusieurs instances ne sont actuellement pas prises en charge. Pour plus d’informations, consultez Prise en charge de plusieurs instances.

L’extension est bloquée en mode de transition ou l’approvisionnement a échoué

Réparez l’extension SQL IaaS Agent. Vérifiez que vous n’avez qu’une seule instance nommée par défaut ou une seule instance nommée. Pour plus d’informations, consultez Prise en charge de plusieurs instances.

Accès refusé à ExtensionLog_0.log

Erreur : EventID:56067 denied access to 'C:\WindowsAzure\Logs\Plugins\Microsoft.SqlServer.Management.SqlIaaSAgent\2.0.x.x\ExtensionLog_0.log'

Ajoutez des autorisations pour le chemin d’accès [NT Service\SQLIaaSExtensionQuery] répertorié dans l’erreur.

Échec de la création de la ressource SQL Machine virtuelle

La ressource de machines virtuelles SQL ne sera pas créée dans les scénarios suivants :

  • Cloner une machine virtuelle
  • Utiliser Azure Site Recovery
  • Migration d'un abonnement, d'un groupe de ressources ou d'une région vers un autre

Réinstallez l’extension SQL IaaS Agent pour résoudre cette erreur.

Échec car l’agent invité/l’agent VM n’est « pas prêt »

Installez l’extension de l’agent de machine virtuelle pour résoudre l’erreur.

L’extension ne fonctionne pas sur des instances multiples

Ceci est normal. Pour plus d’informations, consultez Prise en charge de plusieurs instances.

Service d'extension consommant plus de mémoire/processeur

Si vous voyez cela, supprimez et réinstallez l’extension pour vous assurer que vous êtes sur la dernière version de l’extension SQL IaaS Agent ou redémarrez le service d’extension SQL IaaS Agent à partir de services.msc.

Les fonctionnalités d’extension ne fonctionnent pas avec SQL FCI

Ceci est normal. À l’heure actuelle, les instances de cluster de basculement SQL Server sur des machines virtuelles Azure inscrites auprès de l’extension d’agent IaaS SQL ne prennent en charge qu’un nombre limité de fonctionnalités via un enregistrement de base.

Pour en savoir plus, consultez les articles suivants :