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

{
  “列”: [ { “姓名”: "customer_id", “类型”: 整数 }, { “姓名”: “姓名”, “类型”: “细绳” }, { “姓名”: “城市”, “类型”: “细绳” } ],
  “行”: [
    { "customer_id": 1042, “姓名”: “北风贸易公司”, “城市”: “西雅图” },
    { "customer_id": 1057, “姓名”: “高山装备店”, “城市”: “丹佛” },
    { "customer_id": 1063, “姓名”: “港口食品”, “城市”: “哈利法克斯” }
  ],
  “元”: { 行数: 3, "agent_duration_ms": 41, "request_id": "req_7Hq2mKd9" }
}

驱动程序存在的原因在于，Power BI 必须无论运行在何处，都能与各个数据库的网络协议进行通信，这就是为什么计划刷新需要在您的网络内部部署一个网关。有了端点，已经与数据库关联的代理程序会运行查询，api.querystreams.com 会通过 HTTPS 将请求返回给 Power BI，因此 Power BI 无需安装任何软件，服务也无需建立任何隧道连接。

你需要准备什么

查询流帐户

每个套餐都提供 REST API。免费套餐提供一个端点、两个键，每次调用最多可发送 250 行数据，足以构建本指南。立即注册！ my.querystreams.com.

计算机上的代理程序可以访问您自己的数据库，并且已添加连接。

通常是数据库服务器本身，或者同一网络上的始终在线的计算机。

查询生成器中已保存的查询

该端点仅封装一个已保存的查询。编写 SELECT 语句，运行一次，然后保存。添加动态筛选器（ @variable 在 WHERE 子句中）如果调用者应该能够进行筛选。

此外，还需要 Power BI Desktop 或 Excel 2016 或更高版本。如果您还没有终端， 数据库 REST API 中心 只需四步，即可将已保存的查询转换为 URL。

只需四步即可连接 Power BI

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-Key” = "qsapi_YOUR_KEY"], 查询 = [压缩 = “没有任何”]])), rows = Source[rows], table = Table。来自记录（行）
   在
     桌子

   出口总是要求 压缩=无因为 Power Query 无法解码 LZ4 帧；Power BI 需要的是经过 gzip 压缩的 JSON 格式。

2. 将其粘贴到 Power BI 中

   在 Power BI Desktop 中选择 首页 → 转换数据 → 新建数据源 → 空白查询打开 高级编辑器将其内容替换为该文件，然后单击 完成在 Excel 中，路径是 数据 → 获取数据 → 来自其他来源 → 空白查询然后是相同的高级编辑器。

3. 添加您的密钥

   请将占位符替换为您的 49 位字符密钥，密钥以 1 开头。 qsapi_ 从端点的 共享 选项卡。当 Power BI 询问如何连接时，请选择 匿名钥匙在……中旅行 X-API密钥 查询已设置标头，因此不需要 Power BI 凭据。

4. 加载并刷新

   点击 关闭并应用。 这 行 数组将变成你的表格，每列对应一个查询列。发布到 Power BI 服务并设置刷新计划：由于数据源是 Web URL，因此不需要本地网关。每次刷新都只是对终结点的一次调用。 活动 标签。

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"

{
  “列”: [ { “姓名”: "customer_id", “类型”: 整数 }, { “姓名”: “姓名”, “类型”: “细绳” }, { “姓名”: “城市”, “类型”: “细绳” } ],
  “行”: [
    { "customer_id": 1042, “姓名”: “北风贸易公司”, “城市”: “西雅图” },
    { "customer_id": 1057, “姓名”: “高山装备店”, “城市”: “丹佛” },
    { "customer_id": 1063, “姓名”: “港口食品”, “城市”: “哈利法克斯” }
  ],
  “元”: { 行数: 3, "agent_duration_ms": 41, "request_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"}}'

格式=csv

格式为 CSV 而非 JSON，包含表头行。 接受：文本/CSV 也一样。流式端点返回 NDJSON（每行一个 JSON 对象），并以结尾结尾。 {"_summary": true, "row_count": N} 检查最后一行。

?sample=true

最多五排，不计费。适合给客户接线。

压缩=lz4

适用于高流量呼叫者的 LZ4 框架机身，配备解码器； 代码 选项卡中包含每种语言的解码器代码片段。客户端发送文件时，会自动进行纯 gzip 压缩。 Accept-Encoding: gzip.

授权：Bearer qsapi_…

被接受为别名 X-API密钥. 在浏览器代码中使用它。

超越 Power BI

这些计划允许什么？

每次调用都有固定的 60 秒查询超时时间和 8 MiB 的响应大小上限，返回的数据量会计入您套餐的每月数据流量限额，与 Excel 和 Google Sheets 插件使用的限额相同。免费套餐只有一个端点，每月 5 MB 流量，足以满足每天多次调用的小型表格的需求。 请查看定价页面 按计划发放津贴。

对于报表，请将查询限制在可视化所需的列上，其余的交给刷新计划来完成；Power BI 每次刷新都会读取整个结果，因此您的计划的静态行上限就是单个表的上限。

确保安全

当某些事情不起作用时

每个错误体都有其形状 {"error": {"code": "…", "message": "…"}} 每个回应都包含一个 X-QS-请求-ID 邮件头。在联系客服时，请将 ID 号括起来。

Power Query 的两个具体说明： 数据源错误 命名 401 表示 M 文件中的密钥错误或已被撤销； Expression.Error：未找到记录的字段“rows”。 表示该端点返回了一个错误信封，因此请在门户控制台中运行 URL 来读取它。

人们提出的问题

相关指南

• 数据库 REST API：将任何 SQL 查询转换为端点
• Microsoft SQL Server REST API
• PostgreSQL REST API
• 无需 VBA 或 Power Query 即可将 REST API 连接到 Excel