使用 Power BI 可视化数据

在 Windows (64 位) 系统上使用 Microsoft Power BI Desktop。本指南包含 Arrow Flight SQL ODBC 驱动程序和 InfluxDB 3 Power BI 连接器的 Windows (64 位) 安装步骤。

Microsoft Power BI 是一套软件服务、应用和连接器，它们协同工作，将您零散的数据源转化为连贯、视觉沉浸式且具有交互性的洞察。

– Microsoft Power BI 文档

1. 前提条件
2. 安装 Arrow Flight SQL ODBC 驱动程序
3. 安装 Power BI 连接器
4. 在 Power BI 中启用连接器
5. 将 Power BI 连接到 InfluxDB
6. 查询和可视化数据

前提条件

• Windows 操作系统：自定义连接器需要 Windows (macOS 用户可以使用 Parallels 等虚拟化软件)
• Power BI Desktop：下载并安装 Power BI Desktop (提供免费试用)
• InfluxDB 3 Core：一个正在运行的实例，其中包含要查询的数据
• 数据库令牌：您的 管理员令牌

安装 Arrow Flight SQL ODBC 驱动程序

InfluxDB 3 的 Power BI 自定义连接器需要 Arrow Flight SQL ODBC 驱动程序。请在安装 Power BI 连接器之前安装驱动程序。

下载 Arrow Flight SQL ODBC 驱动程序

1. 运行下载的 .msi 安装程序。
2. 使用默认设置按照安装向导进行操作。
3. 完成安装。

验证驱动程序安装

1. 打开 Windows 应用程序 ODBC 数据源管理器 (64 位)。
2. 打开 ODBC 数据源管理器 (64 位) Windows 组件
3. 导航到“驱动程序”选项卡
4. 验证列表中是否出现Arrow Flight SQL ODBC Driver。

安装 Power BI 连接器

安装 ODBC 驱动程序后，下载并安装 InfluxDB 3 的 Power BI 自定义连接器。

下载 InfluxDB 3 Power BI 连接器

将连接器移至自定义连接器目录

1. 如果自定义连接器文件夹不存在，请创建它

   mkdir "$env:USERPROFILE\Documents\Power BI Desktop\Custom Connectors"

2. 将连接器文件移至自定义连接器文件夹

Move-Item "C:\Users\
YOUR_USER
\Downloads\InfluxDB.pqx" `
  "$env:USERPROFILE\Documents\Power BI Desktop\Custom Connectors\"

替换以下内容：

• YOUR_USER：您的 Windows 用户名

在 Power BI 中启用连接器

要使用自定义连接器，您必须调整 Power BI Desktop 的安全设置

1. 打开 Power BI Desktop
2. 选择“文件”>“选项和设置”>“选项”
3. 在“全局”下导航到“安全性”
4. 在“数据扩展”下，选择“(不推荐) 允许任何扩展加载，无需验证或警告”
5. 点击“确定”
6. 重新启动 Power BI Desktop 以使更改生效

将 Power BI 连接到 InfluxDB

安装连接器并重新启动 Power BI Desktop 后

1. 打开Power BI Desktop

2. 点击“获取数据”>“更多”

3. 搜索“InfluxDB 3”并选择它

4. 点击“连接”

5. 在“InfluxDB 3”连接对话框中，配置以下内容

   • 服务器：您的 InfluxDB 3 Core URL，不带端口 (例如，https://)
   • 数据库：您的数据库名称
   • 端口：您的服务器端口 (例如，8181 (默认))
   • 原生查询 (可选)：输入 SQL 查询以限制加载的数据

6. 将“数据连接模式”选择为“DirectQuery”

7. 点击“确定”

8. 当提示输入凭据时

   • 选择“基本”身份验证
   • 用户名：留空或输入任何值
   • 密码：输入您的 管理员令牌

9. 点击“连接”

10. 预览您的数据并点击“加载”

查询和可视化数据

使用原生查询

连接到 InfluxDB 3 时，您可以使用“原生查询”选项执行自定义 SQL 查询

1. 在连接对话框中，启用“原生查询”

2. 在提供的字段中输入您的查询

   SELECT
     time,
     temp,
     room
   FROM
     home
   WHERE
     time >= now() - INTERVAL '7 days'
   ORDER BY
     time DESC
   LIMIT 1000

3. 选择“DirectQuery”作为连接模式

4. 点击“确定”加载数据

创建可视化

加载数据后，Power BI 会在“字段”窗格中显示您的数据集。

在表中查看数据

1. 在“可视化”窗格中，选择“表”可视化
2. 在“字段”窗格中，选择要显示的列
   • time：时间戳列
   • room：标签列
   • temp：字段列
3. 默认情况下，Power BI 会汇总数值字段。要显示原始值
   • 在“字段”或“可视化”窗格中选择字段
   • 转到“建模”选项卡
   • 将“默认汇总”更改为“不汇总”

创建时间序列可视化

1. 在“可视化”窗格中，选择一种可视化类型 (例如，折线图)
2. 将字段拖到相应区域
   • X 轴：time 字段
   • Y 轴：测量字段 (例如，temp)
   • 图例：标签字段 (例如，room)
3. 使用“筛选器”窗格应用其他筛选器
4. 在“格式”窗格中配置可视化属性
5. 保存您的报表

时间序列最佳实践

• 始终在查询中包含时间范围筛选器以限制数据量
• 对基于时间的视觉对象使用 time 列
• 将 Power BI 的日期层次结构功能应用于 time 列
• 仅选择您需要的列以提高查询性能
• 使用 LIMIT 子句限制返回的行数

故障排除

驱动程序未找到

如果 Power BI 或其他应用程序找不到 Arrow Flight SQL ODBC 驱动程序

1. 打开 ODBC 数据源管理器 (64 位) Windows 组件
2. 导航到“驱动程序”选项卡
3. 验证列表中是否出现Arrow Flight SQL ODBC Driver。
4. 如果未列出，请重新安装驱动程序

连接器未找到

如果 Power BI Desktop 未显示 InfluxDB 3 连接器

• 验证 .pqx 文件是否位于正确的位置：Documents\Power BI Desktop\Custom Connectors\
• 确保您在 Power BI 安全设置中启用了自定义连接器
• 复制连接器文件后重新启动 Power BI Desktop

连接错误

如果遇到连接错误

• 验证您的 InfluxDB 3 Core 实例是否正在运行且可访问
• 检查主机 URL 和端口是否正确
  • 本地实例通常使用 https://:8181
• 确保 UseEncryption 已针对您的连接类型正确配置
• 验证网络连接和防火墙规则是否允许连接到指定端口
• 确保您的令牌对指定数据库具有查询权限

身份验证错误

如果身份验证失败

• 验证您的数据库令牌是否有效且未过期
• 确保令牌已正确指定 (在 Power BI 的“密码”字段中)
• 检查令牌是否复制正确，没有多余的空格或字符
• 将“用户名”字段留空或输入任何值

查询错误

如果查询失败或返回错误

• 验证 SQL 语法对 InfluxDB SQL 是否正确
• 检查引用的表 (测量值) 是否存在于数据库中
• 确保列名与您的架构匹配
• 查看 SQL 参考了解支持的功能
• 对于大型结果集，请考虑添加 LIMIT 子句

查询性能

为了获得更好的查询性能

• 在加载数据之前，始终使用 WHERE 子句进行筛选
• 包含时间范围筛选器 (例如，WHERE time >= now() - INTERVAL '7 days') 以限制扫描的数据量
• 仅选择您需要的列
• 使用 LIMIT 子句限制结果大小
• 对于大型数据集，考虑使用 DirectQuery 模式而不是 Import 模式
• 监控查询执行以寻找优化机会