Power BI REST API: Live SQL-gegevens verbinden zonder ODBC-stuurprogramma's

Power BI · REST API in plaats van een driver

Punt Power BI bij een REST API, geen databasestuurprogramma

Power BI maakt normaal gesproken verbinding met een database via een driver op uw computer en, voor geplande vernieuwingen, via een on-premises gateway. Een Query Streams-eindpunt is een gewone HTTPS-URL, die Power BI Desktop en de Power BI-service kunnen lezen met de ingebouwde webconnector. De portal genereert de Power Query M voor u: Exporteren → Power Query M (.pq)Plakken, sleutel toevoegen, klaar. Hetzelfde bestand werkt ook in Excel.

Ongeveer 5 minuten Geen chauffeur, geen gateway De gegevens blijven op uw netwerk. Excel ook

Wat je uiteindelijk overhoudt

Een Power BI-tabel die wordt gevuld met een opgeslagen SQL-query via HTTPS, die in de service kan worden vernieuwd zonder een on-premises gateway, omdat het eindpunt eruitziet als elke andere web-API. Het eindpunt zelf ziet er in de portalconsole als volgt uit:

{
  "stad": "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"}'

{
  "kolommen": [ { "naam": "klant_id", "type": "geheel getal" }, { "naam": "naam", "type": "snaar" }, { "naam": "stad", "type": "snaar" } ],
  "rijen": [
    { "klant_id": 1042, "naam": "Northwind Traders", "stad": "Seattle" },
    { "klant_id": 1057, "naam": "Alpine Outfitters", "stad": "Denver" },
    { "klant_id": 1063, "naam": "Harbour Foods", "stad": "Halifax" }
  ],
  "meta": { "rij_aantal": 3, "agent_duration_ms": 41, "verzoek_id": "req_7Hq2mKd9" }
}

De reden dat er drivers nodig zijn, is dat Power BI het netwerkprotocol van elke database moet kunnen gebruiken, ongeacht waar het draait. Daarom is voor geplande vernieuwing een gateway binnen uw netwerk vereist. Met een endpoint voert de agent die al bij de database aanwezig is de query uit en beantwoordt api.querystreams.com het antwoord via HTTPS aan Power BI. Hierdoor hoeft Power BI niets te installeren en hoeft de service geen tunnelverbinding te maken.

Wat je nodig hebt

Een Query Streams-account

Elk abonnement bevat de REST API. Met het gratis abonnement krijg je één endpoint, twee sleutels en 250 rijen per aanroep, wat voldoende is om deze handleiding te maken. Meld je aan via mijn.querystreams.nl.

De agent bevindt zich op een computer die toegang heeft tot uw eigen database, met de toegevoegde verbinding.

Vaak is dit de databaseserver zelf of een computer die altijd aan staat op hetzelfde netwerk.

Een opgeslagen query in Query Builder

Het eindpunt omvat precies één opgeslagen query. Schrijf de SELECT-query, voer deze eenmaal uit en sla hem op. Voeg een dynamisch filter toe (een @variable (in de WHERE-clausule) als bellers moeten kunnen filteren.

Plus Power BI Desktop, of Excel 2016 of later. Als u nog geen eindpunt hebt, Database REST API-hub Hiermee zet je een opgeslagen zoekopdracht in vier stappen om in een URL.

Verbind Power BI in vier stappen

1. Exporteer het Power Query M-bestand

   In API open uw eindpunt, klik Exporteren en kiezen Power Query M (.pq)Het bestand is compleet. laat … binnen Een expressie met de eindpunt-URL en uw aanroepbare parameters al ingevuld. Het ziet er als volgt uit:

   Exporteren · Power Query M (.pq)

   laten
     Bron = JSON.Document(Web.Inhoud(
       "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19", [Headers = [#"X-API-sleutel" = "qsapi_UW_SLEUTEL"], Query = [compressie = "geen"]])), rijen = Bron[rijen], tabel = Tabel.Uit records(rijen)
   in
     tafel

   Bij de export wordt altijd gevraagd om compressie=geenOmdat Power Query geen LZ4-frames kan decoderen, verwacht Power BI JSON over gzip.

2. Plak het in Power BI

   Kies in Power BI Desktop Startpagina → Gegevens transformeren → Nieuwe bron → Lege query, open de Gevorderde editor, vervang de inhoud door het bestand en klik KlaarIn Excel is het pad Gegevens → Gegevens ophalen → Uit andere bronnen → Lege queryen vervolgens dezelfde geavanceerde editor.

3. Voeg uw sleutel toe

   Vervang de placeholder door uw sleutel van 49 tekens, die begint met... qsapi_ vanaf het eindpunt Delen tab. Wanneer Power BI vraagt hoe u verbinding wilt maken, kiest u Anoniem: de sleutel reist mee in de X-API-sleutel De query stelt de header al in, dus er zijn geen Power BI-referenties nodig.

4. Laden en vernieuwen

   Klik op Sluiten en toepassenDe rijen De array wordt uw tabel met één kolom per querykolom. Publiceer naar de Power BI-service en stel een vernieuwingsschema in: omdat de bron een web-URL is, is er geen on-premises gateway nodig. Elke vernieuwing bestaat uit één aanroep naar het eindpunt. Activiteit tab.

Het verzoek dat Power BI doet

Technisch gezien is het dezelfde aanroep die je met curl kunt doen. Parameters die gemarkeerd zijn als 'Callable' kunnen vanuit Power Query worden doorgegeven 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"

{
  "kolommen": [ { "naam": "klant_id", "type": "geheel getal" }, { "naam": "naam", "type": "snaar" }, { "naam": "stad", "type": "snaar" } ],
  "rijen": [
    { "klant_id": 1042, "naam": "Northwind Traders", "stad": "Seattle" },
    { "klant_id": 1057, "naam": "Alpine Outfitters", "stad": "Denver" },
    { "klant_id": 1063, "naam": "Harbour Foods", "stad": "Halifax" }
  ],
  "meta": { "rij_aantal": 3, "agent_duration_ms": 41, "verzoek_id": "req_7Hq2mKd9" }
}

De rijen worden geretourneerd als objecten, gesleuteld op kolomnaam, met de kolomlijst en een meta Een blok dat aangeeft hoeveel rijen er zijn, of het resultaat is afgekapt en de aanvraag-ID die je kunt gebruiken ter ondersteuning. Dezelfde aanroep als een POST-verzoek plaatst de parameters in een JSON-body, wat de juiste keuze is voor lange lijsten met waarden:

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 in plaats van JSON, inclusief kopregel. Accepteren: tekst/csv doet hetzelfde. Streaming-eindpunten retourneren NDJSON (één JSON-object per regel) met een eindpunt {"_summary": true, "row_count": N} regel; controleer die laatste regel.

?sample=true

Maximaal vijf rijen, niet gefactureerd. Handig voor het aansluiten van een klant.

compressie=lz4

Een LZ4-frame behuizing voor apparaten met een hoog belvolume en een decoder; Code Het tabblad bevat het decoderfragment per taal. Standaard gzip wordt automatisch toegepast wanneer uw client een bericht verzendt. Accept-Encoding: gzip.

Autorisatie: Drager qsapi_…

Geaccepteerd als alias voor X-API-sleutelGebruik het vanuit de browsercode.

Voorbij Power BI

Wat de plannen toestaan

Elke aanroep heeft een vaste time-out van 60 seconden voor de query en een maximale responsgrootte van 8 MiB. De geretourneerde bytes tellen mee voor je maandelijkse datalimiet, dezelfde limiet die de Excel- en Google Sheets-invoegtoepassingen gebruiken. De gratis versie heeft één eindpunt en 5 MB per maand, wat ruim voldoende is voor een kleine tabel die meerdere keren per dag wordt opgevraagd. Bekijk de prijspagina. voor de vergoedingen per plan.

Voor een rapport kunt u de query beperken tot de kolommen die de visualisaties nodig hebben en de rest aan het vernieuwingsschema overlaten; Power BI leest het volledige resultaat bij elke vernieuwing, dus de statische rijlimiet van uw plan is het maximum voor één enkele tabel.

Het veilig bewaren

Als iets niet werkt

Elk foutlichaam heeft de vorm {"error": {"code": "…", "message": "…"}} en elk antwoord bevat een X-QS-Request-Id koptekst. Vermeld het ID tussen aanhalingstekens wanneer u contact opneemt met de supportafdeling.

Twee specifieke kenmerken van Power Query: een DataSource.Error naamgeving 401 Dit betekent dat de sleutel in het M-bestand onjuist is of is ingetrokken; Expression.Error: Het veld 'rows' van het record is niet gevonden. Dit betekent dat het eindpunt een foutmelding heeft geretourneerd. Voer de URL daarom uit in de portalconsole om de foutmelding te lezen.

Vragen die mensen stellen

Gerelateerde handleidingen

• Database REST API: maak van elke SQL-query een eindpunt
• Microsoft SQL Server REST API
• PostgreSQL REST API
• Verbind REST API's met Excel zonder VBA of Power Query