Problembehandlung bei der Azure-Erweiterung für 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 Azure-Versionserweiterung 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 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 Arc-fä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. Nun sollte eine Nachricht wie die folgenden angezeigt werden.

[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 auf Hinweise darauf, dass die Installation verhindert wird. Versuchen Sie, „SqlServerExtension.msi“ aus dem 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 und den Server-Manager, und probieren Sie dann erneut eine der Verbindungsmethoden aus, um die Erweiterung zu installieren.

Erweiterung wurde installiert, aber nicht gestartet

Überprüfen Sie die Protokolldateien auf Anwendungsfehler.

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

Ü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. Führen Sie das Onboarding des Servers für Azure Arc durch, und probieren Sie dann erneut eine der Verbindungsmethoden 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}

Vergewissern Sie sich, dass der verwalteten 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 der SQL Server-Instanzen von Azure Arc