Zum Hauptinhalt springen

Fehlerbehebung

Diese Anleitung behandelt häufige Probleme und Lösungen für den OctoMesh Power BI Connector.

Connector in Power BI Desktop nicht sichtbar​

  1. Überprüfen Sie, ob sich die .pqx-Datei im richtigen Custom-Connectors-Ordner befindet: 
    C:\Users\<YourUsername>\Documents\Power BI Desktop\Custom Connectors
  2. Prüfen Sie, ob Laden aller Erweiterungen zulassen aktiviert ist:
    • Gehen Sie zu Datei > Optionen und Einstellungen > Optionen
    • Wählen Sie unter Sicherheit > Datenerweiterungen die Option Laden aller Erweiterungen ohne Validierung oder Warnung zulassen
  3. Starten Sie Power BI Desktop vollständig neu.

Connector im Gateway nicht sichtbar​

  1. Überprüfen Sie, ob der Connector im Custom-Connectors-Ordner des Gateways installiert ist: 
    C:\Windows\ServiceProfiles\PBIEgwService\Documents\Power BI Desktop\Custom Connectors
  2. Prüfen Sie, ob der Gateway-Dienst nach dem Kopieren des Connectors neu gestartet wurde.
  3. Stellen Sie sicher, dass Aktualisierung von benutzerdefinierten Datenconnectoren der Benutzer zulassen in den Gateway-Einstellungen im Power BI Service aktiviert ist.
  4. Öffnen Sie die Gateway-Anwendung und prüfen Sie den Tab Connectors.

Connector im Power BI Service nicht sichtbar​

  1. Überprüfen Sie, ob der Connector im Tab „Connectors" der Gateway-Anwendung erscheint.
  2. Prüfen Sie die Gateway-Einstellungen im Power BI Service:
    • Einstellungen > Verbindungen und Gateways verwalten
    • Wählen Sie das Gateway > Einstellungen
    • Aktivieren Sie Aktualisierung von benutzerdefinierten Datenconnectoren der Benutzer über diesen Gateway-Cluster zulassen
  3. Starten Sie den Gateway-Dienst neu und aktualisieren Sie die Seite.

Authentifizierungsfehler​

OAuth (Desktop)​

  1. Löschen Sie vorhandene Anmeldeinformationen:
    • Datei > Optionen und Einstellungen > Datenquelleneinstellungen
    • Suchen Sie die OctoMesh-Verbindung und klicken Sie auf Berechtigungen löschen
  2. Authentifizieren Sie sich erneut, indem Sie die Verbindung erneut herstellen.

Client Credentials (Service)​

  1. Überprüfen Sie, ob Client ID und Client Secret korrekt sind.
  2. Stellen Sie sicher, dass das Service Account über die erforderlichen Scopes verfügt:
    • assetTenantAPI.full_access
  3. Überprüfen Sie, ob das Service Account über Zugriffsberechtigungen für den Tenant verfügt.
  4. Prüfen Sie, ob das Client Secret abgelaufen ist.

Verbindungstest schlägt fehl​

  1. Überprüfen Sie, ob die Asset-Repository-URL korrekt und erreichbar ist:
    • Versuchen Sie, die URL in einem Browser zu öffnen
    • Achten Sie auf Tippfehler (z. B. https:// statt http://)
  2. Prüfen Sie, ob die Tenant ID existiert und Sie darauf Zugriff haben.
  3. Überprüfen Sie, ob die Runtime Query ID gültig ist:
    • Öffnen Sie OctoMesh und prüfen Sie, ob die Runtime Query existiert
    • Stellen Sie sicher, dass Ihre Anmeldeinformationen Zugriff auf die Query haben

Gateway meldet „Local Network Problems" oder „Not Reachable"​

Wenn die Gateway-Anwendung anzeigt, dass der Connector korrekt konfiguriert ist, aber Netzwerkprobleme meldet:

1. Gateway-Status prüfen​

Öffnen Sie die Gateway-Anwendung – sie sollte den Status „Ready" anzeigen. Falls nicht, hat das Gateway Verbindungsprobleme zum Power BI Service.

2. Firewall-Einstellungen überprüfen​

Das Gateway benötigt ausgehende Verbindungen zu:

DomainPorts
*.servicebus.windows.net443, 5671, 5672
*.frontend.clouddatahub.net443
login.microsoftonline.com443
*.analysis.windows.net443
*.pbidedicated.windows.net443

3. Gateway-Protokolle prüfen​

Suchen Sie in den Gateway-Protokollen nach Fehlern wie Invalid relays parameter:

C:\Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway\Report

4. Gateway zurücksetzen​

Falls das Problem weiterhin besteht, kann ein vollständiges Zurücksetzen erforderlich sein (siehe unten).

Das Gateway zurücksetzen​

Wenn das Gateway anhaltende Konfigurationsprobleme hat:

Schritt 1: Den Gateway-Dienst stoppen​

  1. Öffnen Sie services.msc
  2. Suchen Sie „On-premises data gateway service"
  3. Klicken Sie auf Beenden

Schritt 2: Das Gateway aus dem Power BI Service entfernen​

  1. Gehen Sie zum Power BI Service
  2. Navigieren Sie zu Einstellungen > Verbindungen und Gateways verwalten
  3. Wählen Sie Ihren Gateway-Cluster
  4. Klicken Sie auf Entfernen oder Löschen

Schritt 3: Die lokale Gateway-Konfiguration löschen​

Löschen oder benennen Sie diesen Ordner um:

C:\Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway

Schritt 4: Das Gateway neu registrieren​

  1. Öffnen Sie die Gateway-Anwendung (als Administrator)
  2. Melden Sie sich mit Ihrem Power-BI-Konto an
  3. Wählen Sie Ein neues Gateway auf diesem Computer registrieren
  4. Vergeben Sie einen Namen und speichern Sie den Wiederherstellungsschlüssel an einem sicheren Ort

Schritt 5: Den OctoMesh Connector neu installieren​

  1. Kopieren Sie OctoMeshConnector.mez oder .pqx nach: 
    C:\Windows\ServiceProfiles\PBIEgwService\Documents\Power BI Desktop\Custom Connectors
  2. Starten Sie den Gateway-Dienst neu

Schritt 6: Die Gateway-Einstellungen neu konfigurieren​

  1. Öffnen Sie den Power BI Service
  2. Gehen Sie zu Einstellungen > Verbindungen und Gateways verwalten
  3. Wählen Sie Ihr neues Gateway > Einstellungen
  4. Aktivieren Sie Custom Connectors (siehe Gateway-Einrichtung)

Aktualisierung im Power BI Service schlägt fehl​

  1. Prüfen Sie den Aktualisierungsverlauf auf Fehlerdetails:

    • Einstellungen des Semantischen Modells > Aktualisieren > Aktualisierungsverlauf

  2. Überprüfen Sie die Gateway-Verbindung:

    • Einstellungen des Semantischen Modells > Gateway- und Cloudverbindungen
    • Stellen Sie sicher, dass die Datenquelle einer Verbindung zugeordnet ist

  3. Testen Sie die Verbindung im Power BI Service:

    • Einstellungen > Verbindungen und Gateways verwalten
    • Wählen Sie die Verbindung > Verbindung testen

  4. Prüfen Sie den Gateway-Status:

    • Öffnen Sie die Gateway-Anwendung auf dem Server
    • Überprüfen Sie, ob „Ready" angezeigt wird

Daten werden nicht aktualisiert​

  1. Prüfen Sie, ob eine Aktualisierung geplant ist:

    • Einstellungen des Semantischen Modells > Aktualisieren > Geplante Aktualisierung

  2. Überprüfen Sie, ob die Runtime Query aktuelle Daten zurückgibt:

    • Testen Sie die Query direkt in OctoMesh

  3. Prüfen Sie den Aktualisierungsverlauf auf etwaige Fehler.

  4. Aktualisieren Sie manuell zum Testen:

    • Arbeitsbereich > Semantisches Modell > Jetzt aktualisieren