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

Article
10/26/2023

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.

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.

Le reste de cette section fournit des informations sur chaque notification de condition d’erreur.

Le service d’extension SQL IaaS Agent 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.

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.

Le service de requête d’extension SQL IaaS Agent 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.

L’extension SQL IaaS Agent 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.

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 :

Connectez-vous au portail Azure.
Accédez à votre ressource machines virtuelles SQL.
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.
Sélectionnez Paramètres de l’extension SQL IaaS Agent sous Aide.
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.

L’inscription de l’extension SQL IaaS Agent échoue et le message d’erreur « La création d’une ressource de machine virtuelle SQL pour les images de machine virtuelle Power BI n’est pas prise en charge » s’affiche.

Notez que l’inscription de l’extension SQL IaaS Agent est bloquée et non prise en charge sur les machines virtuelles Power BI, SQL Server Reporting Server et SQL Server Analysis Service Images déployées à partir de la Place de marché Azure.

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

Désinscrivez votre machine virtuelle SQL de l’extension, 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.

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 votre SQL Server et votre service SQL Browser sont bien lancé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.

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.

Étapes suivantes

Passez en revue les avantages fournis par l’extension d’agent IaaS SQL.
Inscrire manuellement une machine virtuelle unique
Inscrire automatiquement toutes les machines virtuelles dans un abonnement.
Passez en revue les déclarations de confidentialité de l’extension d’agent IaaS SQL.
Passez en revue la liste de contrôle des meilleures pratiques pour optimiser les performances et la sécurité.

Pour en savoir plus, consultez les articles suivants :