Power BI REST API: ODBCドライバーなしでライブSQLデータに接続する

Power BI · ドライバーの代わりにREST APIを使用

ポイント Power BI で REST APIデータベースドライバではありません

Power BI は通常、マシン上のドライバーと、スケジュールされた更新の場合はオンプレミスのゲートウェイを介してデータベースにアクセスします。クエリ ストリームのエンドポイントはプレーンな HTTPS URL なので、Power BI Desktop と Power BI サービスは組み込みの Web コネクタを使用してそれを読み取ります。ポータルは Power Query M を自動的に書き込みます。 エクスポート → Power Query M (.pq)貼り付けて、キーを追加すれば完了です。同じファイルはExcelでも動作します。

約5分 ドライバーなし、ゲートウェイなし データはあなたのネットワーク上に留まります Excelも

最終的に手に入るもの

HTTPS経由で保存されたSQLクエリによってフィードされるPower BIテーブルは、エンドポイントが一般的なWeb APIのように見えるため、オンプレミスのゲートウェイなしでサービス内で更新できます。ポータルコンソールでは、エンドポイント自体は次のようになります。

{
  "市": 「シアトル」
}

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"}'

{
  「列」: [ { "名前": 「顧客ID」, "タイプ": "整数" }, { "名前": "名前", "タイプ": "弦" }, { "名前": "市", "タイプ": "弦" } ],
  「行」: [
    { 「顧客ID」: 1042, "名前": 「ノースウィンド・トレーダーズ」, "市": 「シアトル」 },
    { 「顧客ID」: 1057, "名前": 「アルパイン・アウトフィッターズ」, "市": 「デンバー」 },
    { 「顧客ID」: 1063, "名前": 「ハーバーフーズ」, "市": 「ハリファックス」 }
  ],
  「メタ」: { 「行数」: 3, 「agent_duration_ms」: 41, 「リクエストID」: "req_7Hq2mKd9" }
}

ドライバーが存在する理由は、Power BI が実行場所に関係なく各データベースのワイヤプロトコルと通信する必要があるためです。そのため、スケジュールされた更新にはネットワーク内にゲートウェイが必要になります。エンドポイントを使用すれば、データベースに既に存在するエージェントがクエリを実行し、api.querystreams.com が HTTPS 経由で Power BI に応答します。そのため、Power BI がインストールする必要のあるものも、サービスがトンネル接続する必要のあるものもありません。

必要なもの

クエリストリームアカウント

すべてのプランにREST APIが含まれています。無料プランでは、エンドポイント1つ、キー2つ、呼び出しごとに250行まで利用できます。これはこのガイドを作成するのに十分です。サインアップはこちらから。 my.querystreams.com.

接続を追加した、自分のデータベースにアクセスできるコンピュータ上のエージェント

多くの場合、データベースサーバー自体、または同じネットワーク上の常時稼働しているコンピューターです。

クエリビルダーに保存されたクエリ

エンドポイントは、保存されたクエリを正確に 1 つラップします。SELECT を記述し、一度実行して保存します。動的フィルタ ( 変数 呼び出し元がフィルタリングできるようにするためには、WHERE句で指定します。

さらに Power BI Desktop、または Excel 2016 以降が必要です。エンドポイントがまだない場合は、 データベースREST APIハブ 保存したクエリからURLを作成するまでの手順を4つ紹介します。

Power BI を接続するには、次の 4 つのステップを実行します。

1. Power Query M ファイルをエクスポートする

   で API エンドポイントを開いて、クリックします 輸出 そして選択する Power Query M (.pq)ファイルは完全なものです …を エンドポイントURLと呼び出し可能なパラメータが既に設定された式です。次のようになります。

   エクスポート · Power Query M (.pq)

   させて
     ソース = JSON。書類（ウェブ。コンテンツ(
       "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19", [ヘッダー = [#「X-APIキー」 = 「qsapi_YOUR_KEY」], クエリ = [圧縮 = "なし"]])), rows = Source[rows], table = Table.フロムレコード（行）
   で
     テーブル

   輸出は常に要求する 圧縮なしPower QueryはLZ4フレームをデコードできないため、Power BIが想定しているのはgzipで圧縮されたJSON形式です。

2. Power BIに貼り付けてください

   Power BI Desktopで、 ホーム → データ変換 → 新しいソース → 空のクエリ開く 高度なエディターファイルの内容に置き換えてクリックします 完了Excelではパスは データ → データの取得 → 他のソースから → 空のクエリ次に、同じ高度なエディターを開きます。

3. キーを追加

   プレースホルダーを、49文字のキーに置き換えてください。 qsapi_ エンドポイントから 共有 タブ。Power BI が接続方法を尋ねてきたら、 匿名: 鍵は X-APIキー クエリが既にヘッダーを設定しているため、Power BIの認証情報は不要です。

4. 読み込みと更新

   クリック 閉じる＆適用. 行 配列はクエリ列ごとに 1 つの列を持つテーブルになります。Power BI サービスに発行し、更新スケジュールを設定します。ソースは Web URL であるため、オンプレミス ゲートウェイは不要です。各更新はエンドポイントの 1 つの呼び出しです。 活動 タブ。

Power BI が行うリクエスト

内部的には、curl で実行できる呼び出しと同じです。Callable とマークされたパラメーターは Power Query から渡すことができます。 クエリ = [city = "シアトル"]:

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

{
  「列」: [ { "名前": 「顧客ID」, "タイプ": "整数" }, { "名前": "名前", "タイプ": "弦" }, { "名前": "市", "タイプ": "弦" } ],
  「行」: [
    { 「顧客ID」: 1042, "名前": 「ノースウィンド・トレーダーズ」, "市": 「シアトル」 },
    { 「顧客ID」: 1057, "名前": 「アルパイン・アウトフィッターズ」, "市": 「デンバー」 },
    { 「顧客ID」: 1063, "名前": 「ハーバーフーズ」, "市": 「ハリファックス」 }
  ],
  「メタ」: { 「行数」: 3, 「agent_duration_ms」: 41, 「リクエストID」: "req_7Hq2mKd9" }
}

行は列名をキーとするオブジェクトとして返され、列リストと メタ 行数、結果が切り捨てられたかどうか、およびサポートのために引用できるリクエスト ID を示すブロック。POST と同じ呼び出しでパラメータが JSON ボディに格納されます。これは、長い値のリストに適した方法です。

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

JSONではなくCSV形式で、ヘッダー行も含まれます。 受け入れ可能な形式: text/csv も同様です。ストリーミングエンドポイントは、最終的な NDJSON (1 行に 1 つの JSON オブジェクト) を返します。 {"_summary": true, "row_count": N} 行; 最後の行を確認してください。

?sample=true

最大5行まで、課金対象外。顧客への配線に最適です。

?圧縮=lz4

デコーダーを備えた大音量発信者向けのLZ4フレームボディ。 コード タブには言語ごとのデコーダーのスニペットがあります。通常のgzipは、クライアントが送信するときに自動的に行われます。 Accept-Encoding: gzip.

認証: Bearer qsapi_…

別名として受け入れられた X-APIキーブラウザのコードから使用します。

Power BI を超えて

計画で許可されている内容

すべての呼び出しには、60秒の固定クエリタイムアウトと8MiBの応答上限が設定されており、返されるバイト数は、ExcelやGoogleスプレッドシートのアドインと同じ、プランの月間データ許容量にカウントされます。無料プランではエンドポイントが1つ、月間5MBまで利用できますが、これは1日に何度も呼び出される小さなテーブルであれば十分対応できます。 価格ページをご覧ください プランごとの手当について。

レポートの場合は、クエリをビジュアルに必要な列のみに限定し、残りは更新スケジュールに任せましょう。Power BI は更新のたびに結果全体を読み込むため、プランの静的な行上限が単一テーブルの上限となります。

安全に保つ

何かがうまくいかないとき

すべてのエラーボディは、 {"error": {"code": "…", "message": "…"}} そしてすべての反応には X-QSリクエストID ヘッダー。サポートに問い合わせる際は、IDを引用してください。

Power Queryの具体的な2点： データソースエラー ネーミング 401 これは、Mファイル内のキーが間違っているか、または失効していることを意味します。 Expression.Error: レコードのフィールド「rows」が見つかりませんでした これはエンドポイントがエラーエンベロープを返したことを意味します。ポータルコンソールでURLを実行して内容を確認してください。

人々が尋ねる質問

関連ガイド

• データベースREST API：あらゆるSQLクエリをエンドポイントに変換する
• Microsoft SQL Server REST API
• PostgreSQL REST API
• VBAやPower Queryを使わずにREST APIをExcelに接続する