Freigeben über


Problembehandlung der Azure-Erweiterung für die Bereitstellung von SQL Server

Gilt für:SQL Server

Notieren Sie sich den Speicherort der Protokolle, bevor Sie beginnen.

Protokolldateispeicherorte

Erweiterungsprotokoll

Die Erweiterungsprotokolldatei ist unter:

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\

Der Name der Protokolldatei hängt von der Version Azure Erweiterung für SQL Server ab, für die neueste Version der Azure Erweiterung für SQL Server lautet die Protokolldatei:

unifiedagent.log

Für die Erweiterungsversion 1.1.24724.69 und frühere Versionen lautet die Protokolldatei:

ExtensionLog_0.log

Bereitstellungsprotokolle

Die Bereitstellungsprotokolle werden bereitgestellt unter:

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\<extension version>\deployer.log

Ersetzen Sie <extension version> durch Ihre Erweiterungsversion. Zum Beispiel:

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\1.1.0.0\deployer.log

Der Fehler beim Erstellen der arcfähigen SQL Server Ressource kann durch mehrere Probleme verursacht werden.

Fehler bei der Installation der Erweiterung

Navigieren Sie zum verbundenen Server, und überprüfen Sie das Bereitstellungsprotokoll. Sie sollten die nachfolgenden Nachrichten sehen.

[YY/MM/DDDD HH:MM:SS UTC] [INFO]          Status of service 'SqlServerExtension' before attempting start: Stopped
[YY/MM/DDDD HH:MM:SS UTC] [INFO]          Status of service 'SqlServerExtension' after attempting start: Stopped

Wenn sie nicht angezeigt wird, ist die Erweiterung nicht ordnungsgemäß installiert. Probieren Sie die folgenden Schritte aus:

  1. Überprüfen Sie die Ereignisprotokolle, um festzustellen, ob etwas die Installation verhindert. Versuchen Sie, SqlServerExtension.msi aus dem folgenden Ordner C:\Packages\Plugins\Microsoft.AzureData.WindowsAgent.SqlServer{version} zu installieren. Auf der Benutzeroberfläche für die Installation werden ggf. die Fehlerdetails angezeigt.

  2. Schließen Sie die Dienst-App, den Server-Manager, und versuchen Sie es erneut, die Verbindungsmethode zum Installieren der Erweiterung zu verwenden, und überprüfen Sie, ob dies hilft.

Erweiterung wurde installiert, aber nicht gestartet

Überprüfen Sie die Protokolldateien auf Anwendungsfehler.

Server – Azure Arc ARM-Ressource manuell gelöscht wurde

Überprüfen Sie das Erweiterungsprotokoll auf den folgenden Eintrag:

[YY/MM/DDDD HH:MM:SS PM UTC] [ERROR]   [UploadServiceProvider]      [ExtensionHandlerStatusQueryError] ArcSqlInstancesRequest request is null, not sending data to RP.

Dies bedeutet, dass der Computer nicht mehr als verbundener Server erkannt wird. Binden Sie den Server an Azure Arc an und probieren Sie eine der Verbindungsmethoden erneut aus, um die Erweiterung zu installieren.

Serverseitig verwaltete Identität verfügt über unzureichende Berechtigungen

Überprüfen Sie das Erweiterungsprotokoll auf den folgenden Eintrag:

[INFO] [UploadServiceProvider] [ExtensionHandlerArcUploadServicesNotifications] [AzureUpload] Arc post request failed with error: Forbidden message: {"ErrorDescription":{"ErrorCode":6,"Message":"The user has no access to the provided Azure resource."},"ResponseUrl":null}

Stellen Sie sicher, dass der verwaltete Identität des Computers die Rolle Azure Connected SQL Server Onboarding zugewiesen wurde. Siehe die Rollenzuweisungsanweisungen unter Wenn der Computer bereits mit Arc-fähigem Server verbunden ist.

Der Benutzer hat die Arc-fähige SQL Server-Ressource nicht zum neuen Ressourcenanbieter migriert.

Überprüfen Sie das Erweiterungsprotokoll auf den folgenden Eintrag:

[YY/MM/DDDD HH:MM:SS PM UTC] [INFO] [UploadServiceProvider] [ExtensionHandlerArcUploadServicesNotifications] [AzureUpload] Arc for Sql Server upload response status: InternalServerError.`

Stellen Sie sicher, dass Sie die Arc-fähige SQL Server-Ressource zu Microsoft.AzureArcData migrieren.

Wenn die Erweiterung lange in einem ungewöhnlichen Zustand (Erstellen/Löschen) hängen bleibt

Trennen Sie Ihre SQL Server-Instanzen von Azure Arc

Gelöschte Ressource wird weiterhin im Azure-Portal angezeigt

Hinweis

Nachdem Sie eine SQL Server - Azure Arc Ressource gelöscht haben, kann die Ressource möglicherweise für einen bestimmten Zeitraum im Azure-Portal angezeigt werden. Dieses Verhalten wird erwartet und wird durch Azure Resource Manager Zwischenspeicherung verursacht. Die Ressource verschwindet in der Regel nach der Aktualisierung des Caches. Wenn die Ressource nach mehreren Stunden noch angezeigt wird, können Sie überprüfen, ob sie erfolgreich gelöscht wurde, indem Sie Azure Resource Graph oder die Azure CLI verwenden. Es ist keine weitere Aktion erforderlich – die Ressource ist nicht funktionsfähig und verursacht nach dem Löschen keine Gebühren.