API REST Power BI : Connexion aux données SQL en direct sans pilotes ODBC

Power BI · API REST au lieu d'un pilote

Indiquer Power BI à un API REST, pas un pilote de base de données

Power BI accède généralement à une base de données via un pilote installé sur votre machine et, pour l'actualisation planifiée, via une passerelle locale. Un point de terminaison Query Streams est une simple URL HTTPS ; Power BI Desktop et le service Power BI la lisent donc grâce au connecteur Web intégré. Le portail génère la requête Power Query M pour vous. Exporter → Power Query M (.pq)Collez, ajoutez votre clé, et voilà ! Le même fichier fonctionne également dans Excel.

Environ 5 minutes Pas de pilote, pas de passerelle Les données restent sur votre réseau Excel aussi

Ce que vous obtiendrez

Une table Power BI alimentée par une requête SQL enregistrée via HTTPS, actualisable dans le service sans passerelle locale, car le point de terminaison ressemble à n'importe quelle API web. Voici à quoi ressemble ce point de terminaison dans la console du portail :

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

{
  « colonnes »: [ { "nom": "customer_id", "taper": "entier" }, { "nom": "nom", "taper": "chaîne" }, { "nom": "ville", "taper": "chaîne" } ],
  "rangées": [
    { "customer_id": 1042, "nom": « Les Marchands du Vent du Nord », "ville": "Seattle" },
    { "customer_id": 1057, "nom": « Pourvoyeurs alpins », "ville": "Denver" },
    { "customer_id": 1063, "nom": "Harbour Foods", "ville": "Halifax" }
  ],
  "méta": { "row_count": 3, "agent_duration_ms": 41, "request_id": "req_7Hq2mKd9" }
}

L'existence de pilotes est nécessaire car Power BI doit communiquer avec le protocole réseau de chaque base de données, quel que soit son emplacement d'exécution. C'est pourquoi l'actualisation planifiée requiert une passerelle au sein de votre réseau. Avec un point de terminaison, l'agent déjà installé auprès de la base de données exécute la requête et api.querystreams.com répond à Power BI via HTTPS. Ainsi, Power BI n'a rien à installer et le service n'a aucun tunnel à établir.

Ce dont vous aurez besoin

Un compte Query Streams

Chaque forfait inclut l'API REST. Le forfait gratuit vous offre un point de terminaison, deux clés et 250 lignes par requête, ce qui est suffisant pour créer ce guide. Inscrivez-vous sur mon.querystreams.com.

L'agent installé sur un ordinateur capable d'accéder à votre propre base de données, la connexion étant ajoutée.

Souvent, il s'agit du serveur de base de données lui-même ou d'un ordinateur toujours allumé sur le même réseau.

Une requête enregistrée dans le générateur de requêtes

Le point de terminaison encapsule exactement une requête enregistrée. Rédigez la requête SELECT, exécutez-la une fois, puis enregistrez-la. Ajoutez un filtre dynamique (un @variable dans la clause WHERE) si les appelants doivent pouvoir filtrer.

De plus, Power BI Desktop ou Excel 2016 ou version ultérieure. Si vous ne disposez pas encore d'un point de terminaison, le Hub d'API REST de base de données permet de passer d'une requête enregistrée à une URL en quatre étapes.

Connectez Power BI en quatre étapes

1. Exporter le fichier M de Power Query

   Dans API ouvrez votre point de terminaison, cliquez Exporter et choisissez Power Query M (.pq)Le fichier est complet. laissez entrer… L'expression contient déjà l'URL du point de terminaison et vos paramètres d'appel. Elle ressemble à ceci :

   Exporter · Power Query M (.pq)

   laisser
     Source = Json.Document(Web.Contenu(
       "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19", [En-têtes = [#« Clé X-API » = "qsapi_VOTRE_CLÉ"], Requête = [compression = "aucun"]])), lignes = Source[lignes], table = Table.FromRecords(lignes)
   dans
     tableau

   L'exportation demande toujours compression=aucune, car Power Query ne peut pas décoder les trames LZ4 ; Power BI attend du JSON compressé (gzip).

2. Collez-le dans Power BI

   Dans Power BI Desktop, choisissez Accueil → Transformer les données → Nouvelle source → Requête vide, ouvrez le Éditeur avancé, remplacez son contenu par le fichier et cliquez TerminéDans Excel, le chemin est Données → Obtenir des données → À partir d'autres sources → Requête vide, puis le même éditeur avancé.

3. Ajoutez votre clé

   Remplacez l'espace réservé par votre clé de 49 caractères commençant par qsapi_ à partir du point de terminaison Partage onglet. Lorsque Power BI vous demande comment vous connecter, choisissez Anonyme: la clé voyage dans le Clé X-API L'en-tête est déjà défini par la requête, aucune information d'identification Power BI n'est donc nécessaire.

4. Charger et actualiser

   Cliquez sur Fermer et postuler. Le rangées Le tableau devient votre table avec une colonne par colonne de requête. Publiez-le sur le service Power BI et définissez une planification d'actualisation : comme la source est une URL web, aucune passerelle locale n'est requise. Chaque actualisation correspond à un appel à l'URL du point de terminaison. Activité languette.

La requête Power BI

En interne, il s'agit du même appel que celui que vous pouvez effectuer avec curl. Les paramètres marqués comme pouvant être appelés peuvent être transmis depuis Power Query. Requête = [ville = "Seattle"]:

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

{
  « colonnes »: [ { "nom": "customer_id", "taper": "entier" }, { "nom": "nom", "taper": "chaîne" }, { "nom": "ville", "taper": "chaîne" } ],
  "rangées": [
    { "customer_id": 1042, "nom": « Les Marchands du Vent du Nord », "ville": "Seattle" },
    { "customer_id": 1057, "nom": « Pourvoyeurs alpins », "ville": "Denver" },
    { "customer_id": 1063, "nom": "Harbour Foods", "ville": "Halifax" }
  ],
  "méta": { "row_count": 3, "agent_duration_ms": 41, "request_id": "req_7Hq2mKd9" }
}

Les lignes sont renvoyées sous forme d'objets indexés par nom de colonne, avec la liste des colonnes et un méta Ce bloc indique le nombre de lignes, si le résultat a été tronqué et l'identifiant de la requête que vous pouvez citer pour obtenir de l'aide. Un appel POST place les paramètres dans un corps JSON, ce qui est idéal pour les longues listes de valeurs.

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 au lieu de JSON, ligne d'en-tête incluse. Accepter : texte/csv Il en va de même. Les points de terminaison de flux renvoient du NDJSON (un objet JSON par ligne) avec un résultat final {"_summary": true, "row_count": N} ligne ; vérifiez cette dernière ligne.

?sample=true

Cinq rangées maximum, non facturées. Idéal pour le câblage d'un client.

?compression=lz4

Un châssis LZ4 pour les appelants à volume élevé avec décodeur ; Code L'onglet contient l'extrait de code du décodeur pour chaque langue. La compression gzip simple s'effectue automatiquement lorsque votre client envoie des données. Accept-Encoding: gzip.

Autorisation : Porteur qsapi_…

Accepté comme alias pour Clé X-APIUtilisez-le depuis le code du navigateur.

Au-delà de Power BI

Ce que les plans permettent

Chaque requête est soumise à un délai d'attente fixe de 60 secondes et à une limite de réponse de 8 Mio. Les octets renvoyés sont décomptés de votre forfait de données mensuel, le même que celui utilisé par les modules complémentaires Excel et Google Sheets. La version gratuite inclut un point de terminaison et 5 Mo par mois, ce qui suffit amplement pour une petite table consultée plusieurs fois par jour. Consultez la page des prix pour les indemnités prévues par le régime.

Pour un rapport, limitez la requête aux colonnes nécessaires aux visualisations et laissez la planification d'actualisation faire le reste ; Power BI lit l'intégralité du résultat à chaque actualisation, donc la limite de lignes statique de votre plan correspond au plafond pour une seule table.

Le garder en sécurité

Quand quelque chose ne fonctionne pas

Chaque corps d'erreur a la forme {"erreur": {"code": "…", "message": "…"}} et chaque réponse comporte un Identifiant de requête X-QS En-tête. Veuillez indiquer l'identifiant lorsque vous écrivez au support.

Deux spécificités de Power Query : a DataSource.Erreur appellation 401 signifie que la clé dans le fichier M est incorrecte ou a été révoquée ; Expression.Error : Le champ « rows » de l’enregistrement est introuvable. Cela signifie que le point de terminaison a renvoyé une enveloppe d'erreur ; exécutez donc l'URL dans la console du portail pour la lire.

Questions que se posent les gens

Guides associés

• API REST de base de données : transformez n’importe quelle requête SQL en un point de terminaison
• API REST de Microsoft SQL Server
• API REST PostgreSQL
• Connectez des API REST à Excel sans VBA ni Power Query.