API REST di Power BI: Connetti dati SQL in tempo reale senza driver ODBC

Power BI · API REST anziché un driver

Punto Power BI a API RESTnon è un driver di database

Power BI accede normalmente a un database tramite un driver installato sul computer e, per gli aggiornamenti pianificati, tramite un gateway locale. Un endpoint di Query Streams è un URL HTTPS semplice, quindi Power BI Desktop e il servizio Power BI lo leggono con il connettore Web integrato. Il portale genera automaticamente la query Power Query M. Esporta → Power Query M (pq)Incolla, aggiungi la tua chiave, fatto. Lo stesso file funziona anche in Excel.

Circa 5 minuti Nessun driver, nessun gateway I dati rimangono sulla tua rete Anche Excel

Quello che otterrai alla fine

Una tabella di Power BI alimentata da una query SQL salvata tramite HTTPS, aggiornabile nel servizio senza bisogno di un gateway locale, poiché l'endpoint ha l'aspetto di una qualsiasi API web. L'endpoint stesso appare in questo modo nella console del portale:

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

{
  "colonne": [ { "nome": "customer_id", "tipo": "intero" }, { "nome": "nome", "tipo": "corda" }, { "nome": "città", "tipo": "corda" } ],
  "file": [
    { "customer_id": 1042, "nome": "Commercianti del Vento del Nord", "città": "Seattle" },
    { "customer_id": 1057, "nome": "Alpine Outfitters", "città": "Denver" },
    { "customer_id": 1063, "nome": "Harbour Foods", "città": "Halifax" }
  ],
  "meta": { "conteggio_righe": 3, "durata_agente_ms": 41, "request_id": "req_7Hq2mKd9" }
}

I driver sono necessari perché Power BI deve comunicare con il protocollo di rete di ciascun database, indipendentemente dal server su cui viene eseguito. Per questo motivo, l'aggiornamento pianificato richiede un gateway all'interno della rete locale. Con un endpoint, l'agente già presente nel database esegue la query e api.querystreams.com risponde a Power BI tramite HTTPS, quindi Power BI non deve installare nulla e il servizio non deve connettersi tramite tunnel.

Cosa ti servirà

Un account Query Streams

Ogni piano include l'API REST. Il piano gratuito offre un endpoint, due chiavi e 250 righe per chiamata, sufficienti per realizzare questa guida. Registrati su my.querystreams.com.

L'agente su un computer che può raggiungere il tuo database, con la connessione aggiunta

Spesso si tratta del server di database stesso o di un computer sempre acceso sulla stessa rete.

Una query salvata in Query Builder

L'endpoint incapsula esattamente una query salvata. Scrivi la SELECT, eseguila una volta, salvala. Aggiungi un filtro dinamico (un @variable nella clausola WHERE) se i chiamanti devono essere in grado di filtrare.

Inoltre Power BI Desktop o Excel 2016 o versioni successive. Se non disponi ancora di un endpoint, Hub API REST del database Ti permette di convertire una query salvata in un URL in quattro passaggi.

Connettere Power BI in quattro passaggi

1. Esporta il file Power Query M

   In API apri il tuo endpoint, fai clic Esportare e scegliere Power Query M (pq)Il file è completo lasciare … dentro espressione con l'URL dell'endpoint e i parametri della funzione richiamabile già presenti. Ha questo aspetto:

   Esportazione · Power Query M (pq)

   permettere
     Origine = Json.Documento(Web.Contenuto(
       "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19", [Intestazioni = [#"Chiave API X" = "qsapi_LA_TUA_CHIAVE"], Query = [compressione = "nessuno"]])), righe = Sorgente[righe], tabella = Tabella.Da Records(righe)
   In
     tavolo

   L'esportazione richiede sempre compressione=nessuna, perché Power Query non è in grado di decodificare i frame LZ4; Power BI si aspetta JSON su gzip.

2. Incollalo in Power BI

   In Power BI Desktop scegli Home → Trasforma dati → Nuova origine → Query vuota, apri il Editor avanzato, sostituisci il suo contenuto con il file e fai clic FattoIn Excel il percorso è Dati → Ottieni dati → Da altre fonti → Query vuota, quindi lo stesso editor avanzato.

3. Aggiungi la tua chiave

   Sostituisci il segnaposto con la tua chiave di 49 caratteri che inizia con qsapi_ dall'endpoint Condivisione scheda. Quando Power BI chiede come connettersi, scegli Anonimo: la chiave viaggia nel Chiave X-API L'intestazione è già impostata dalla query, quindi non sono necessarie credenziali di Power BI.

4. Carica e aggiorna

   Cliccare Chiudi e applica. IL file L'array diventa la tua tabella con una colonna per ogni colonna di query. Pubblica nel servizio Power BI e imposta una pianificazione di aggiornamento: poiché l'origine è un URL Web, non è richiesto alcun gateway locale. Ogni aggiornamento è una chiamata all'endpoint. Attività tab.

La richiesta che Power BI effettua

Dietro le quinte è la stessa chiamata che puoi fare con curl. I parametri contrassegnati come Callable possono essere passati da Power Query come Query = [città = "Seattle"]:

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

{
  "colonne": [ { "nome": "customer_id", "tipo": "intero" }, { "nome": "nome", "tipo": "corda" }, { "nome": "città", "tipo": "corda" } ],
  "file": [
    { "customer_id": 1042, "nome": "Commercianti del Vento del Nord", "città": "Seattle" },
    { "customer_id": 1057, "nome": "Alpine Outfitters", "città": "Denver" },
    { "customer_id": 1063, "nome": "Harbour Foods", "città": "Halifax" }
  ],
  "meta": { "conteggio_righe": 3, "durata_agente_ms": 41, "request_id": "req_7Hq2mKd9" }
}

Le righe vengono restituite come oggetti indicizzati dal nome della colonna, con l'elenco delle colonne e un meta blocco che indica il numero di righe, se il risultato è stato troncato e l'ID della richiesta che puoi citare all'assistenza. La stessa chiamata come POST inserisce i parametri in un corpo JSON, che è la scelta giusta per lunghi elenchi di valori:

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

File CSV anziché JSON, con riga di intestazione inclusa. Accetta: testo/csv fa lo stesso. Gli endpoint di streaming restituiscono NDJSON (un oggetto JSON per riga) con un finale {"_summary": true, "row_count": N} riga; controlla quell'ultima riga.

?sample=true

Massimo cinque file, non fatturate. Utile per cablare un cliente.

?compression=lz4

Un corpo con telaio LZ4 per chiamanti ad alto volume con decoder; il Codice la scheda contiene il frammento del decodificatore per lingua. La semplice compressione gzip avviene automaticamente quando il client invia Accept-Encoding: gzip.

Autorizzazione: Portatore qsapi_…

Accettato come alias per Chiave X-API. Utilizzalo dal codice del browser.

Oltre Power BI

Cosa consentono i piani

Ogni chiamata ha anche un timeout fisso di 60 secondi e un limite di risposta di 8 MiB, e i byte restituiti vengono conteggiati nel limite dati mensile del tuo piano, lo stesso limite utilizzato dai componenti aggiuntivi di Excel e Fogli Google. La versione gratuita ha un endpoint e 5 MB al mese, che sono più che sufficienti per una piccola tabella richiamata più volte al giorno. Consulta la pagina dei prezzi per le indennità previste dal piano.

Per un report, limita la query alle colonne necessarie per gli elementi visivi e lascia che la pianificazione dell'aggiornamento si occupi del resto; Power BI legge l'intero risultato a ogni aggiornamento, quindi il limite statico di righe del tuo piano rappresenta il limite massimo per una singola tabella.

Tenerlo al sicuro

Quando qualcosa non funziona

Ogni corpo di errore ha la forma {"errore": {"codice": "…", "messaggio": "…"}} e ogni risposta porta con sé un X-QS-Request-Id Intestazione. Citare l'ID quando si scrive all'assistenza.

Due dettagli specifici di Power Query: a Errore origine dati denominazione 401 significa che la chiave nel file M è errata o è stata revocata; Expression.Error: Il campo 'rows' del record non è stato trovato significa che l'endpoint ha restituito una busta di errore, quindi esegui l'URL nella console del portale per leggerla.

Domande che le persone si pongono

Guide correlate

• API REST del database: trasforma qualsiasi query SQL in un endpoint
• API REST di Microsoft SQL Server
• API REST di PostgreSQL
• Collega le API REST a Excel senza VBA o Power Query