Power BI REST API: Live-SQL-Daten ohne ODBC-Treiber verbinden

Power BI · REST-API anstelle eines Treibers

Punkt Power BI bei einem REST-API, kein Datenbanktreiber

Power BI greift normalerweise über einen Treiber auf Ihrem Rechner und, für geplante Aktualisierungen, über ein lokales Gateway auf eine Datenbank zu. Ein Query-Streams-Endpunkt ist eine einfache HTTPS-URL, die von Power BI Desktop und dem Power BI-Dienst mit dem integrierten Webconnector gelesen wird. Das Portal generiert die Power Query M-Anweisung automatisch. Export → Power Query M (.pq)Einfügen, Schlüssel hinzufügen, fertig. Dieselbe Datei funktioniert auch in Excel.

Ungefähr 5 Minuten Kein Treiber, kein Gateway Die Daten bleiben in Ihrem Netzwerk. Excel auch

Was am Ende dabei herauskommt

Eine Power BI-Tabelle, die über eine gespeicherte SQL-Abfrage via HTTPS gespeist wird und im Dienst ohne lokales Gateway aktualisiert werden kann, da der Endpunkt wie jede beliebige Web-API aussieht. Der Endpunkt selbst sieht in der Portalkonsole folgendermaßen aus:

{
  "Stadt": "Seattle"
}

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"city": "Seattle"}'

{
  "Spalten": [ { "Name": "customer_id", "Typ": "ganze Zahl" }, { "Name": "Name", "Typ": "Zeichenkette" }, { "Name": "Stadt", "Typ": "Zeichenkette" } ],
  "Zeilen": [
    { "customer_id": 1042, "Name": "Northwind Traders", "Stadt": "Seattle" },
    { "customer_id": 1057, "Name": "Alpine Outfitters", "Stadt": "Denver" },
    { "customer_id": 1063, "Name": "Harbour Foods", "Stadt": "Halifax" }
  ],
  "Meta": { "Zeilenanzahl": 3, "agent_duration_ms": 41, "request_id": "req_7Hq2mKd9" }
}

Treiber sind notwendig, da Power BI das jeweilige Datenbankprotokoll unabhängig vom Ausführungsort beherrschen muss. Daher benötigt die geplante Aktualisierung ein Gateway im Netzwerk. Mit einem Endpunkt führt der bereits in der Datenbank befindliche Agent die Abfrage aus, und api.querystreams.com beantwortet die Anfragen von Power BI über HTTPS. Power BI muss daher nichts installieren, und der Dienst muss keinen Tunnel aufbauen.

Was Sie benötigen

Ein Query Streams-Konto

Jeder Tarif beinhaltet die REST-API. Die kostenlose Version bietet einen Endpunkt, zwei Schlüssel und 250 Zeilen pro Aufruf – ausreichend für diese Anleitung. Jetzt anmelden unter mein.querystreams.de.

Der Agent befindet sich auf einem Computer, der auf Ihre eigene Datenbank zugreifen kann, wobei die Verbindung hinzugefügt wurde.

Häufig handelt es sich um den Datenbankserver selbst oder einen ständig eingeschalteten Computer im selben Netzwerk.

Eine gespeicherte Abfrage im Abfrage-Generator

Der Endpunkt umschließt genau eine gespeicherte Abfrage. Schreiben Sie die SELECT-Anweisung, führen Sie sie einmal aus und speichern Sie sie. Fügen Sie einen dynamischen Filter hinzu (einen dynamischen Filter). @variable in der WHERE-Klausel), wenn Aufrufer die Möglichkeit haben sollen, zu filtern.

Zusätzlich benötigen Sie Power BI Desktop oder Excel 2016 oder höher. Falls Sie noch keinen Endpunkt haben, Datenbank-REST-API-Hub führt Sie in vier Schritten von einer gespeicherten Suchanfrage zu einer URL.

Power BI in vier Schritten verbinden

1. Exportieren Sie die Power Query M-Datei

   In API Öffnen Sie Ihren Endpunkt, klicken Sie Export und wählen Power Query M (.pq)Die Datei ist vollständig lassen … herein Ausdruck mit der Endpunkt-URL und den bereits vorhandenen aufrufbaren Parametern. Er sieht folgendermaßen aus:

   Exportieren · Power Query M (.pq)

   lassen
     Quelle = Json.Dokumentieren(Web.Inhalt(
       "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19", [Headers = [#"X-API-Schlüssel" = "qsapi_YOUR_KEY"], Abfrage = [Komprimierung = "keiner"]])), rows = Source[rows], table = Table.Aus Datensätzen(Zeilen)
   In
     Tisch

   Der Export fragt immer nach Komprimierung=keine, weil Power Query LZ4-Frames nicht dekodieren kann; Power BI erwartet JSON über gzip.

2. Fügen Sie es in Power BI ein.

   In Power BI Desktop auswählen Startseite → Daten transformieren → Neue Quelle → Leere Abfrage, öffnen Sie die Erweiterter EditorErsetzen Sie dessen Inhalt durch die Datei und klicken Sie auf FertigIn Excel lautet der Pfad: Daten → Daten abrufen → Aus anderen Quellen → Leere Abfragedann derselbe erweiterte Editor.

3. Fügen Sie Ihren Schlüssel hinzu

   Ersetzen Sie den Platzhalter durch Ihren 49-stelligen Schlüssel, beginnend mit qsapi_ vom Endpunkt Teilen Registerkarte. Wenn Power BI nach der Verbindungsmethode fragt, wählen Sie aus Anonym: der Schlüssel reist in der X-API-Schlüssel Der Header wird bereits in der Abfrage festgelegt, daher sind keine Power BI-Anmeldeinformationen erforderlich.

4. Laden und aktualisieren

   Klicken Sie auf Schließen & Anwenden. Der Zeilen Das Array wird zu Ihrer Tabelle mit einer Spalte pro Abfragespalte. Veröffentlichen Sie die Daten im Power BI-Dienst und legen Sie einen Aktualisierungszeitplan fest: Da die Quelle eine Web-URL ist, ist kein lokales Gateway erforderlich. Jede Aktualisierung entspricht einem Aufruf des Endpunkts. Aktivität Tab.

Die Anfrage, die Power BI stellt

Im Prinzip handelt es sich um denselben Aufruf, den Sie auch mit curl durchführen können. Parameter, die als „Callable“ markiert sind, können von Power Query übergeben werden als Query = [city = "Seattle"]:

curl "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19?city=Seattle" \ -H "X-API-Key: qsapi_YOUR_KEY"

{
  "Spalten": [ { "Name": "customer_id", "Typ": "ganze Zahl" }, { "Name": "Name", "Typ": "Zeichenkette" }, { "Name": "Stadt", "Typ": "Zeichenkette" } ],
  "Zeilen": [
    { "customer_id": 1042, "Name": "Northwind Traders", "Stadt": "Seattle" },
    { "customer_id": 1057, "Name": "Alpine Outfitters", "Stadt": "Denver" },
    { "customer_id": 1063, "Name": "Harbour Foods", "Stadt": "Halifax" }
  ],
  "Meta": { "Zeilenanzahl": 3, "agent_duration_ms": 41, "request_id": "req_7Hq2mKd9" }
}

Die Zeilen werden als Objekte zurückgegeben, die über den Spaltennamen indiziert sind, mit der Spaltenliste und einem Meta Ein Block, der die Anzahl der Zeilen, die Information, ob das Ergebnis gekürzt wurde, und die Anfrage-ID anzeigt, die Sie zur Unterstützung angeben können. Derselbe Aufruf wie ein POST-Request übermittelt die Parameter in einem JSON-Body, was die richtige Wahl für lange Wertelisten ist:

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"params": {"city": "Seattle"}}'

?format=csv

CSV statt JSON, inklusive Kopfzeile. Akzeptierte Formate: text/csv Dasselbe gilt für Streaming-Endpunkte. Diese geben NDJSON (ein JSON-Objekt pro Zeile) mit einem abschließenden Wert zurück. {"_summary": true, "row_count": N} Zeile; überprüfen Sie die letzte Zeile.

?sample=true

Maximal fünf Reihen, nicht abgerechnet. Gut geeignet, um einen Kunden anzuschließen.

?compression=lz4

Ein Gehäuse des Typs LZ4 für Vieltelefonierer mit Decoder; Code Die Registerkarte enthält den Decoder-Codeausschnitt für jede Sprache. Die einfache Gzip-Komprimierung erfolgt automatisch, wenn Ihr Client sendet. Accept-Encoding: gzip.

Autorisierung: Bearer qsapi_…

Akzeptiert als Alias für X-API-Schlüssel. Verwenden Sie es im Browsercode.

Über Power BI hinaus

Was die Pläne erlauben

Jeder Aufruf hat ein festes Abfrage-Timeout von 60 Sekunden und eine Antwortgröße von maximal 8 MiB. Die zurückgegebenen Bytes werden auf Ihr monatliches Datenvolumen angerechnet – dasselbe, das auch die Add-ons für Excel und Google Sheets nutzen. Die kostenlose Version bietet einen Endpunkt und 5 MB Datenvolumen pro Monat, was für eine kleine Tabelle, die mehrmals täglich aufgerufen wird, problemlos ausreicht. Siehe die Preisseite für die Zulagen nach Plan.

Für einen Bericht beschränken Sie die Abfrage auf die Spalten, die die Visualisierungen benötigen, und überlassen Sie den Rest dem Aktualisierungszeitplan; Power BI liest bei jeder Aktualisierung das gesamte Ergebnis, daher ist die statische Zeilenbegrenzung Ihres Plans die Obergrenze für eine einzelne Tabelle.

Es sicher aufbewahren

Wenn etwas nicht funktioniert

Jeder Fehlerkörper hat die Form {"error": {"code": "…", "message": "…"}} und jede Antwort beinhaltet eine X-QS-Anforderungs-ID Header. Geben Sie die ID in Anführungszeichen an, wenn Sie sich an den Support wenden.

Zwei Besonderheiten von Power Query: a DataSource.Error Benennung 401 bedeutet, dass der Schlüssel in der M-Datei falsch ist oder widerrufen wurde; Expression.Error: Das Feld 'rows' des Datensatzes wurde nicht gefunden. Das bedeutet, dass der Endpunkt einen Fehlerumschlag zurückgegeben hat. Rufen Sie daher die URL in der Portalkonsole auf, um diesen zu lesen.

Fragen, die Menschen stellen

Verwandte Leitfäden

• Datenbank-REST-API: Jede SQL-Abfrage in einen Endpunkt umwandeln
• Microsoft SQL Server REST-API
• PostgreSQL REST-API
• Verbinden Sie REST-APIs mit Excel ohne VBA oder Power Query