Zum Hauptinhalt springen

On-premises Data Gateway – Einrichtung

Um den OctoMesh Connector im Power BI Service mit geplanter Datenaktualisierung zu verwenden, müssen Sie ein On-premises Data Gateway einrichten.

Voraussetzungen​

  • On-premises Data Gateway auf einem Windows-Server installiert
  • Administratorzugriff auf den Gateway-Server
  • Power-BI-Service-Konto mit Gateway-Administratorberechtigungen

Schritt 1: Den Connector auf dem Gateway installieren​

  1. Laden Sie die Datei OctoMeshConnector-*.pqx aus dem Download Center auf den Gateway-Server herunter.

  2. Kopieren Sie die Datei in den Ordner Custom Connectors des Gateways:

    C:\Windows\ServiceProfiles\PBIEgwService\Documents\Power BI Desktop\Custom Connectors
    Wichtig

    Dieser Pfad unterscheidet sich vom Custom-Connectors-Ordner des Benutzers. Der Gateway-Dienst läuft unter einem separaten Konto (PBIEgwService).

  3. Starten Sie den Gateway-Dienst neu:

    • Öffnen Sie Dienste (services.msc)
    • Suchen Sie On-premises data gateway service
    • Klicken Sie auf Neu starten

Schritt 2: Die Connector-Installation überprüfen​

  1. Öffnen Sie die Anwendung On-premises data gateway.
  2. Navigieren Sie zum Tab Connectors.
  3. Überprüfen Sie, ob OctoMeshConnector in der Liste erscheint.

Gateway Connectors Tab

Schritt 3: Custom Connectors im Power BI Service aktivieren​

  1. Öffnen Sie den Power BI Service.
  2. Navigieren Sie zu Einstellungen (Zahnradsymbol) > Verbindungen und Gateways verwalten.
  3. Wählen Sie Ihren Gateway-Cluster.
  4. Klicken Sie auf Einstellungen (Drei-Punkte-Menü > Einstellungen).
  5. Aktivieren Sie unter Power BI die folgenden Optionen:
    • Aktualisierung von Cloud-Datenquellen der Benutzer über diesen Gateway-Cluster zulassen
    • Aktualisierung von benutzerdefinierten Datenconnectoren der Benutzer über diesen Gateway-Cluster zulassen
  6. Klicken Sie auf Speichern.

Gateway Settings

Schritt 4: Eine Verbindung erstellen​

Eine Runtime Query in OctoMesh erstellen​

  1. Melden Sie sich bei Ihrem OctoMesh-Konto an.
  2. Navigieren Sie zum Abschnitt Runtime Queries, siehe Dokumentation zum Runtime Query Builder.
  3. Erstellen Sie eine neue Runtime Query oder wählen Sie eine bestehende aus.
  4. Notieren Sie die rtId der Runtime Query, die Sie verwenden möchten.

Die Verbindung im Power BI Service erstellen​

  1. Gehen Sie im Power BI Service zu Einstellungen > Verbindungen und Gateways verwalten.
  2. Klicken Sie auf + Neu, um eine neue Verbindung zu erstellen.
  3. Wählen Sie Ihren Gateway-Cluster.
  4. Konfigurieren Sie die Verbindung:
    • Verbindungsname: Ein aussagekräftiger Name (z. B. OctoMesh-Production)
    • Verbindungstyp: Wählen Sie OctoMesh aus der Dropdown-Liste
    • Asset Repository Service URI: Die URL Ihres OctoMesh Asset Repository (z. B. https://assets.<cluster>.octo-mesh.com/ – ersetzen Sie <cluster> durch den Cluster, auf dem Ihr Tenant läuft, etwa prod-1 oder prod-2)
    • Tenant ID: Die Kennung Ihres OctoMesh-Tenants (z. B. meshdemo)
    • Runtime Query ID: Die rtId der Runtime Query

Authentifizierung konfigurieren​

Wählen Sie Service Account (Client Credentials) als Authentifizierungsmethode:

  • Client ID: Die im OctoMesh Identity Service konfigurierte OAuth-Client-ID
  • Client Secret: Das Client Secret für das Service Account

Connection with Client Credentials

Einrichtung von Client Credentials

Wenden Sie sich an Ihren OctoMesh-Administrator, um ein Service Account zu erstellen mit:

  • Grant Type: client_credentials
  • Scopes: assetTenantAPI.full_access

Das Service Account muss über Zugriffsberechtigungen für den Tenant und die Runtime Query verfügen, die Sie verwenden möchten.

  1. Klicken Sie auf Erstellen, um die Verbindung zu speichern.

Nächste Schritte​