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

Gilt für: SQL Server auf Azure-VMs

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.

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:

1. Melden Sie sich beim Azure-Portal an.

2. Wechseln Sie zu Ihrer Ressource Virtuelle SQL-Computer.

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

4. Wählen Sie unter Hilfe die Option SQL IaaS-Agent-Erweiterungseinstellungen aus.

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

   

Der Hauptdienst der 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 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.

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.

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

Fehler „Bild wird nicht unterstützt“

Die Registrierung der SQL IaaS-Agent-Erweiterung wird für die folgenden nicht unterstützten Azure Marketplace-Bilder blockiert:

• Virtueller Power BI-Computer
• SQL Server Analysis Services

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.

Löschen Sie die Erweiterung von Ihrer SQL Server-VM, 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.

Die SQL IaaS-Agent-Erweiterung kann nicht installiert werden, wenn TCP/IP in SQL Server-Konfigurations-Manager oder auf VM-Ebene deaktiviert ist.

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, überprüfen Sie, ob Ihre SQL Server-Instanz und der SQL-Browserdienst innerhalb der VM gestartet wurden. 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.
• Wenn Sie Ihre SQL Server-VM mit Premium SSDv2 bereitgestellt haben.
• Wenn TCP/IP in SQL Server-Konfigurations-Manager oder auf VM-Ebene deaktiviert ist.

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.

TCP/IP ist deaktiviert

Die SQL IaaS-Agent-Erweiterung erfordert, dass TCP/IP sowohl in SQL Server-Konfigurations-Manager als auch auf VM-Ebene aktiviert ist. Das Deaktivieren von TCP/IP kann zu unvorhersehbaren Verhaltensweisen führen, z. B. fehlschlagende Installationen oder einige Features, die nicht wie erwartet funktionieren.

Die SQL-Instanz für das Ziel konnte nicht gefunden werden

Fehler: Unable to find SQL instance to target. Skipping 'NT Service\\SQLIaaSExtensionQuery' removal from SQL logins ist eine Warnmeldung, die sicher ignoriert werden kann.

Diese Nachricht wird möglicherweise in der Windows-Ereignisanzeige angezeigt, wenn Ihr Abonnement über die automatische Registrierung verfügt, aber auf Ihrem virtuellen Azure-Computer kein SQL Server installiert ist. In diesem Fall können Sie diese Nachricht einfach ignorieren.

Dienst MSSQLSERVER wurde auf dem Computer nicht gefunden

Fehler: 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

Die SQL IaaS Agent-Erweiterung funktioniert nur mit einer Standardinstanz oder einer benannten Instanz. Weitere Informationen können Sie in der Unterstützung mehrerer Instanzen überprüfen.

Der Dienst mit dem Namen 'MSSQLSERVER' wird nicht ausgeführt

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

Überprüfen Sie, ob der SQL Server-Dienst für die Standardinstanz innerhalb des virtuellen Computers ausgeführt wird, oder „Reparieren Sie die IaaS-Erweiterung”. Wenn Sie über mehrere SQL Server-Instanzen verfügen, funktioniert die SQL IaaS-Agent-Erweiterung nicht, da derzeit nicht mehrere Instanzen unterstützt werden. Weitere Informationen können Sie in der Unterstützung mehrerer Instanzen überprüfen.

Erweiterung bleibt in der Übergangsphase oder bei der Bereitstellung im Zustand „Fehler“ hängen

Reparieren Sie die SQL-IaaS-Agent-Erweiterung. Stellen Sie sicher, dass Sie nur über eine Standardinstanz oder eine benannte Instanz verfügen. Weitere Informationen können Sie in der Unterstützung mehrerer Instanzen überprüfen.

Zugriff auf ExtensionLog_0.log verweigert

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

Fügen Sie Berechtigungen für den [NT Service\SQLIaaSExtensionQuery] im Fehler aufgeführten Pfad hinzu.

SQL VM-Ressource konnte nicht erstellt werden

Die Ressource für virtuelle SQL-Computer wird in den folgenden Szenarien nicht erstellt:

• Einen virtuellen Computer klonen
• Verwendung von Azure Site Recovery
• Migration von einem Abonnement, einer Ressourcengruppe oder einer Region zu einer anderen

Installieren Sie die SQL IaaS-Agent-Erweiterung erneut, um diesen Fehler zu beheben.

Fehlgeschlagen aufgrund des Guest Agent/ VM Agent-Status „Nicht bereit“

Installieren Sie die VM-Agent-Erweiterung, um den Fehler zu beheben.

Die Erweiterung funktioniert nicht mit mehreren Instanzen

Dies entspricht dem erwarteten Verhalten. Weitere Informationen können Sie in der Unterstützung mehrerer Instanzen überprüfen.

Der Erweiterungsdienst verbraucht mehr Arbeitsspeicher/CPU

Wenn dies angezeigt wird, entfernen Sie die Erweiterung und installieren Sie sie erneut, um sicherzustellen, dass sich die SQL IaaS Agent-Erweiterung auf der aktuellen Version befindet, oder starten Sie den SQL IaaS Agent-Erweiterungsdienst über services.msc neu.

Erweiterungsfeatures funktionieren nicht mit SQL FCI

Dies entspricht dem erwarteten Verhalten. Derzeit unterstützen SQL Server-Failoverclusterinstanzen auf virtuellen Azure-Computern, die bei der SQL-IaaS-Agent-Erweiterung registriert sind, nur eine begrenzte Anzahl von Features, die über die Basisregistrierung verfügbar sind.

Zugehöriger Inhalt

• 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:

• Was ist SQL Server auf virtuellen Azure-Computern? (Windows)
• Häufig gestellte Fragen zu SQL Server auf virtuellen Windows-Computern
• Preisinformationen für SQL Server auf virtuellen Azure-Computern
• Neuerungen für SQL Server auf Azure-VMs