Bekannte Probleme und Problembehandlung für die SQL Server-IaaS-Agent-Erweiterung

Artikel
10/26/2023

Dieser Artikel unterstützt Sie dabei, bekannte Probleme bei Verwendung der SQL Server-IaaS-Agent-Erweiterung zu lösen und Fehler zu beheben.

Antworten auf häufig gestellte Fragen zur Erweiterung finden Sie in den Häufig gestellten Fragen (FAQ).

Überprüfen der Voraussetzungen

Prüfen Sie die Voraussetzungen für die Erweiterung, um Fehler aufgrund von nicht unterstützten Optionen oder Einschränkungen zu vermeiden.

Wenn Sie die SQL-IaaS-Agent-Erweiterung reparieren oder neu installieren, wird Ihre Einstellung nicht beibehalten, mit Ausnahme von Lizenzierungsänderungen. Wenn Sie die Erweiterung repariert oder neu installiert haben, müssen Sie die automatisierte Sicherung, das automatisierte Patchen und alle anderen Dienste neu konfigurieren, die Sie vor der Reparatur oder Neuinstallation konfiguriert haben.

Überprüfen der Erweiterungsintegrität

Sie können die Integrität Ihrer Erweiterung auf der Seite Übersicht der Ressource ihrer virtuellen SQL-Computer im Azure-Portal unter Erweiterungs-Integritätsstatus überprüfen.

Hinweis

Sie können auch ein PowerShell-Skript verwenden, um den Status der Erweiterungsintegrität auf Ihren VMs zu überprüfen. Das vollständige Skript finden Sie auf GitHub unter Abrufen des Status der SQL-IaaS-Agent-Erweiterungsintegrität mit Az PowerShell.

Der Status der SQL IaaS-Agent-Erweiterung kann Folgendes sein:

Fehlerfrei: Alles funktioniert erwartungsgemäß.
Fehler: Der Hauptdienst des SQL IaaS Agent läuft nicht auf der SQL Server-VM.
Fehlerhaft: Ein oder mehrere Teildienste haben ein Problem.

Wenn der Status der SQL IaaS-Agent-Erweiterung entweder fehlerhaft oder fehlgeschlagen ist, überprüfen Sie Benachrichtigungen auf der Seite Übersicht, um weitere Details zu erhalten.

Der Rest dieses Abschnitts enthält Informationen zu jeder Fehlerbedingungsbenachrichtigung.

Der Hauptdienst der SQL IaaS Agent-Erweiterung wird nicht ausgeführt

Der Hauptdienst für die SQL IaaS Agent-Erweiterung (Microsoft SQL Server IaaS-Agent) befindet sich in einem angehaltenen Zustand. Der Erweiterungsstatus des SQL IaaS-Agents ist aufgrund dieses Fehlers fehlgeschlagen.

Um diese Fehlerbedingung zu beheben, reparieren Sie die Erweiterung.

Der SQL Server wird nicht ausgeführt

Der SQL Server-Dienst ist gestoppt. Der Erweiterungsstatus des SQL IaaS-Agents ist aufgrund dieses Fehlers fehlerhaft.

Untersuchen Sie den Dienst weiter, und starten Sie den Dienst neu.

Der SQL IaaS-Agent-Erweiterungsabfragedienst wird nicht ausgeführt

Die SQL IaaS-Agent-Erweiterung verwendet den Abfragedienst (Microsoft SQL Server IaaS-Abfragedienst), um mit SQL Server zu kommunizieren. Wenn sich der Abfragedienst in einem angehaltenen Zustand befindet, funktionieren Features, die auf der Kommunikation mit SQL Server basieren, nicht. Der Erweiterungsstatus des SQL IaaS-Agents ist aufgrund dieses Fehlers fehlerhaft.

Um diese Fehlerbedingung zu beheben, reparieren Sie die Erweiterung.

Die SQL IaaS-Agent-Erweiterung verfügt nicht über die richtigen Berechtigungen.

Der SQL IaaS-Agent-Erweiterungsabfragedienst (Microsoft SQL Server IaaS-Abfragedienst) verwendet das Konto NT Service\SQLIaaSExtensionQuery, um die SQL Server-Instanz abzufragen. Wenn diese Anmeldung von SQL Server entfernt wird oder wenn eine Benutzer- oder Domänenrichtlinie die Berechtigungen für die Anmeldung ändert, wird die Fehlermeldung angezeigt, dass die Erweiterung nicht die richtigen Berechtigungen hat. Der Erweiterungsstatus des SQL IaaS-Agents ist aufgrund dieses Fehlers fehlerhaft.

Überprüfen Sie für SQL Server-VMs, die das Modell der geringsten Berechtigungen verwenden, ob das Konto NT Service\SQLIaaSExtensionQuery über die richtigen Berechtigungen für die einzelnen aktivierten Features verfügt. Wenn keine Features aktiviert sind, wird der Fehler angezeigt, wenn die Anmeldung NT Service\SQLIaaSExtensionQuery nicht in SQL Server vorhanden ist oder Microsoft SQL Server IaaS-Abfragedienst unter einem anderen Benutzernamen ausgeführt wird als NT Service\SQLIaaSExtensionQuery.

Einige vor Oktober 2022 bereitgestellte SQL Server-VMs verwenden möglicherweise weiterhin das ältere Sysadmin-Berechtigungsmodell. Für diese älteren virtuellen Computer wird der Berechtigungsfehler angezeigt, wenn NT Service\SQLIaaSExtensionQuery nicht vorhanden ist oder keine Sysadmin-Rechte in SQL Server besitzt oder wenn Microsoft SQL Server IaaS-Abfragedienst unter einem anderen Benutzernamen ausgeführt wird als NT Service\SQLIaaSExtensionQuery.

Um diese Fehlerbedingung zu beheben, vergewissern Sie sich, dass die Anmeldung in SQL Server vorhanden ist und dass sie über die richtigen Berechtigungen verfügt, basierend auf den Features, die Sie aktiviert haben. Möglicherweise müssen Sie die Anmeldung neu erstellen und/oder die richtigen Berechtigungen zuweisen. Darüber hinaus wird überprüft, ob der Microsoft SQL Server IaaS-Abfragedienst unter dem Benutzernamen NT Service\SQLIaaSExtensionQuery ausgeführt wird.

Reparieren der Erweiterung

Es ist möglich, dass sich Ihre Erweiterung für den SQL-IaaS-Agent in einem fehlerhaften Zustand befindet. Verwenden Sie das Azure-Portal, um die Erweiterung für den SQL-IaaS-Agent zu reparieren.

So reparieren Sie die Erweiterung mit dem Azure-Portal:

Melden Sie sich beim Azure-Portal an.
Wechseln Sie zu Ihrer Ressource Virtuelle SQL-Computer.
Wählen Sie die SQL Server-VM in der Liste aus. Wenn Ihre SQL Server-VM hier nicht aufgeführt ist, wurde sie wahrscheinlich nicht bei der Erweiterung für den SQL-IaaS-Agent registriert.
Wählen Sie unter Hilfe die Option SQL IaaS-Agent-Erweiterungseinstellungen aus.
Wenn der Bereitstellungsstatus Fehler ist, wählen Sie Reparieren aus, um die Erweiterung zu reparieren. Wenn der Status Erfolgreich ist, können Sie das Kontrollkästchen neben Reparatur erzwingen aktivieren, um die Erweiterung unabhängig vom Status zu reparieren.

Fehler bei der Registrierung der SQL-IaaS-Agent-Erweiterung mit der Fehlermeldung „Erstellen einer SQL-VM-Ressource für Power BI-VM-Images wird nicht unterstützt“

Beachten Sie, dass die SQL-IaaS-Agent-Erweiterungsregistrierung auf einer Power BI-VM, einem SQL Server-Berichtsserver und von SQL Server Analysis Service Images, die von Azure Marketplace bereitgestellt werden, blockiert und nicht unterstützt wird.

Ungültiger Status für die Verwaltung

Reparieren Sie die Erweiterung, wenn die folgende Fehlermeldung angezeigt wird:

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

Ungültiger Status der zugrunde liegenden VM

Wenn Sie die folgende Fehlermeldung erhalten:

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

Beachten Sie Folgendes:

Die SQL-VM wurde möglicherweise angehalten, freigegeben, befindet sich in einem fehlerhaften Zustand oder wurde nicht gefunden. Überprüfen Sie, ob die zugrunde liegende VM ausgeführt wird.
Ihre Erweiterung für den SQL-IaaS-Agent befindet sich möglicherweise in einem fehlerhaften Zustand. Reparieren Sie die Erweiterung.

Heben Sie die Registrierung Ihrer SQL-VM für die Erweiterung auf, und registrieren Sie die SQL-VM erneut bei der Erweiterung, wenn einer der folgenden Fälle vorliegt:

Sie haben Ihre VM von einem Abonnement zu einem anderen Abonnement migriert.
Sie haben das Gebietsschema oder die Sortierung von SQL Server geändert.
Sie haben die Version Ihrer SQL Server-Instanz geändert.
Sie haben die Edition für Ihre SQL Server-Instanz geändert.

Fehler bei der Bereitstellung.

Reparieren Sie die Erweiterung, wenn die Erweiterung für den SQL-IaaS-Agent im Azure-Portal mit dem Status Fehler bei der Bereitstellung angezeigt wird.

SQL-VM-Ressource im Portal nicht verfügbar

Wenn die Erweiterung für den SQL-IaaS-Agent installiert wurde und die VM online ist, aber die SQL-VM-Ressource im Azure-Portal nicht zur Verfügung steht. Stellen Sie sicher, dass Ihr SQL Server- und SQL-Browserdienst innerhalb des virtuellen Computers gestartet werden. Wenn das Problem dadurch nicht behoben wird, reparieren Sie die Erweiterung.

Features werden abgeblendet dargestellt

Wenn Sie im Azure-Portal zu Ihrer SQL-VM-Ressource navigieren und dort Funktionen abgeblendet dargestellt werden, überprüfen Sie, ob die SQL-VM ausgeführt wird und Sie die aktuelle Version der Erweiterung für den SQL-IaaS-Agent besitzen.

Geändertes Dienstkonto

Wenn Sie die Dienstkonten für einen der beiden mit der Erweiterung verbundenen Dienste ändern, kann dies zu Fehlern oder einem unvorhersehbaren Verhalten der Erweiterung führen.

Die zwei Dienste sollten mit den folgenden Konten ausgeführt werden:

Der Microsoft SQL Server-IaaS-Agent ist der Hauptdienst für die SQL-IaaS-Agent-Erweiterung und sollte mit dem Konto Lokales System ausgeführt werden.
Der Microsoft SQL Server-IaaS-Abfragedienst ist ein Hilfsdienst, der die Erweiterung beim Ausführen von Abfragen innerhalb von SQL Server unterstützt und mit dem NT-DienstkontoNT Service\SqlIaaSExtensionQuery ausgeführt werden sollte.

Fehler bei der automatischen Registrierung

Wenn die automatische Registrierung bei einigen SQL Server-VMs fehlgeschlagen ist, überprüfen Sie die SQL Server-Version auf den VMs, bei denen die Registrierung nicht erfolgreich war. Azure-VMs mit SQL Server 2016 oder höher werden standardmäßig automatisch bei der Erweiterung für den SQL-IaaS-Agent registriert, wenn sie vom CEIP-Dienst erkannt werden. SQL Server-VMs mit Versionen vor 2016 müssen manuell registriert werden, einzeln oder per Massenvorgang.

Hoher Ressourcenverbrauch

Wenn Sie feststellen, dass die Erweiterung für den SQL-IaaS-Agent einen unerwartet hohen CPU- oder Arbeitsspeicherverbrauch aufweist, überprüfen Sie, ob die neueste Version der Erweiterung verwendet wird. Falls ja, starten Sie den Microsoft SQL Server-IaaS-Agent über services.msc neu.

Datenträger können nicht erweitert werden

Eine Erweiterung Ihrer Datenträger über die Seite Speicherkonfiguration der Ressource SQL-VM ist in den folgenden Fällen nicht möglich:

Wenn Sie die Erweiterung für den SQL-IaaS-Agent deinstallieren und neu installieren.
Wenn Sie Ihre SQL Server-Instanz deinstallieren und neu installieren.
Wenn Sie bei der Bereitstellung Ihres SQL Server-Images aus dem Azure Marketplace eine benutzerdefinierte Namenskonvention für den Datenträger-/Speicherpoolnamen verwendet haben.

Datenträgerkonfiguration während der Bereitstellung abgeblendet

Wenn Sie Ihre SQL Server-VM mit einem nicht verwalteten Datenträger erstellen, wird die Datenträgerkonfiguration entwurfsbedingt abgeblendet dargestellt.

Automatisierte Sicherung deaktiviert

Wenn für Ihre SQL-VM-Ressource der Hinweis Automatische Sicherung zurzeit deaktiviert angezeigt wird, überprüfen Sie, ob für Ihre SQL Server-Instanz verwaltete Sicherungen aktiviert wurden. Wenn Sie automatische Sicherungen über das Azure-Portal nutzen möchten, deaktivieren Sie verwaltete Sicherungen in SQL Server.

Erweiterung verharrt in Übergangszustand

Ihre Erweiterung für den SQL-IaaS-Agent kann in den folgenden Szenarien in einem Übergangszustand verharren:

Sie haben den Dienst NT service\SQLIaaSExtension aus den SQL Server-Anmeldungen und/oder der Gruppe der lokalen Administratoren entfernt.
Einer dieser beiden Dienste wurde in „services.msc“ beendet
- Microsoft SQL Server-IaaS-Agent
- Microsoft SQL Server-IaaS-Abfragedienst

Fehler Installation auf Domänencontroller

Die Registrierung einer auf Ihrem Domänencontroller installierten SQL Server-Instanz bei der Erweiterung für den SQL-IaaS-Agent wird nicht unterstützt. Durch eine Registrierung bei der Erweiterung wird der Benutzer NT Service\SQLIaaSExtension erstellt, und da dieser Benutzer nicht auf dem Domänencontroller erstellt werden kann, wird eine Registrierung dieser VM beim SQL-IaaS-Agent nicht unterstützt.

Nächste Schritte

Informieren Sie sich über die Vorteile der Erweiterung für den SQL-IaaS-Agent.
Manuelles Registrieren einer einzelnen VM
Registrieren Sie automatisch alle VMs in einem Abonnement.
Lesen Sie die Datenschutzbestimmungen für die Erweiterung für den SQL-IaaS-Agent.
Überprüfen Sie die Checkliste für bewährte Methoden, um Leistung und Sicherheit zu optimieren.

Weitere Informationen finden Sie in den folgenden Artikeln: