跳到主要内容
跳到主要内容

Power BI

ClickHouse Supported

Microsoft Power BI 可以从 ClickHouse Cloud 或自管理部署中查询或加载到内存数据。

您可以使用几种 Power BI 的版本来可视化您的数据:

  • Power BI Desktop:用于创建仪表板和可视化的 Windows 桌面应用程序
  • Power BI Service:作为 SaaS 在 Azure 中提供,用于托管在 Power BI Desktop 中创建的仪表板

Power BI 需要您在 Desktop 版本中创建仪表板并将其发布到 Power BI Service。

本教程将指导您完成以下过程:

前提条件

Power BI 安装

本教程假定您已经在 Windows 计算机上安装了 Microsoft Power BI Desktop。您可以在 这里 下载并安装 Power BI Desktop。

我们建议您更新到最新版本的 Power BI。ClickHouse 连接器从版本 2.137.751.0 开始默认可用。

收集您的 ClickHouse 连接详细信息

您需要以下详细信息以连接到您的 ClickHouse 实例:

  • 主机名 - ClickHouse
  • 用户名 - 用户凭证
  • 密码 - 用户的密码
  • 数据库 - 您要连接的实例中的数据库名称

Power BI Desktop

要开始在 Power BI Desktop 中查询数据,您需要完成以下步骤:

  1. 安装 ClickHouse ODBC 驱动程序
  2. 查找 ClickHouse 连接器
  3. 连接到 ClickHouse
  4. 查询和可视化数据

安装 ODBC 驱动程序

下载最新的 ClickHouse ODBC 版本

执行提供的 .msi 安装程序并按照向导进行操作。

ClickHouse ODBC 驱动程序安装向导显示安装选项

备注

调试符号 是可选的,不是必需的

验证 ODBC 驱动程序

当驱动程序安装完成后,您可以通过以下方式验证安装是否成功:

在开始菜单中搜索 ODBC 并选择 "ODBC 数据源 (64 位)"。

Windows 搜索显示 ODBC 数据源 (64 位) 选项

验证 ClickHouse 驱动程序是否列出。

ODBC 数据源管理器显示 Drivers 选项卡中的 ClickHouse 驱动程序

查找 ClickHouse 连接器

备注

在 Power BI Desktop 的版本 2.137.751.0 中可用

在 Power BI Desktop 启动屏幕上,点击 "获取数据"。

Power BI Desktop 主屏幕显示获取数据按钮

搜索 "ClickHouse"

Power BI 获取数据对话框的搜索框中搜索 ClickHouse

连接到 ClickHouse

选择连接器,并输入 ClickHouse 实例凭据:

  • 主机(必填) - 您的实例域名/地址。确保添加时没有前缀/后缀。
  • 端口(必填) - 您的实例端口。
  • 数据库 - 您的数据库名称。
  • 选项 - 任何 ODBC 选项,如在 ClickHouse ODBC GitHub 页面 中列出
  • 数据连接模式 - DirectQuery
ClickHouse 连接对话框显示主机、端口、数据库和连接模式字段

备注

我们建议选择 DirectQuery 以直接查询 ClickHouse。

如果您有少量数据的用例,可以选择导入模式,整个数据将加载到 Power BI。

  • 指定用户名和密码
ClickHouse 连接凭据对话框,输入用户名和密码

查询和可视化数据

最后,您应该在导航器视图中看到数据库和表。选择所需的表并单击 "加载" 以从 ClickHouse 导入数据。

Power BI 导航器视图显示 ClickHouse 数据库表和示例数据

导入完成后,您的 ClickHouse 数据应在 Power BI 中如常访问。


Power BI Service

要使用 Microsoft Power BI Service,您需要创建一个 本地数据网关

有关如何设置自定义连接器的更多详细信息,请参阅 Microsoft 的文档,了解如何 使用自定义数据连接器与本地数据网关

ODBC 驱动程序(仅导入)

我们建议使用 ClickHouse 连接器,它使用 DirectQuery。

ODBC 驱动程序 安装到本地数据网关实例,并按照以上所述进行 验证

创建新的用户 DSN

当驱动程序安装完成后,可以创建 ODBC 数据源。在开始菜单中搜索 ODBC 并选择 "ODBC 数据源(64 位)"。

Windows 搜索显示 ODBC 数据源 (64 位) 选项

我们需要在这里添加一个新的用户 DSN。单击左侧的 "添加" 按钮。

ODBC 数据源管理器中突出显示的添加按钮以创建新的 DSN

选择 ODBC 驱动程序的 Unicode 版本。

创建新数据源对话框显示 ClickHouse Unicode 驱动程序选择

填写连接详细信息。

ClickHouse ODBC 驱动程序配置对话框显示连接参数

备注

如果您使用的是启用 SSL 的部署(例如,ClickHouse Cloud 或自管理实例),在 SSLMode 字段中应提供 require

  • Host 应始终省略协议(即 http://https://)。
  • Timeout 是表示秒数的整数。默认值:30 秒

将数据导入到 Power BI

如果您尚未安装 Power BI,请 下载并安装 Power BI Desktop

在 Power BI Desktop 启动屏幕上,单击 "获取数据"。

Power BI Desktop 主屏幕显示获取数据按钮

选择 "其他" -> "ODBC"。

Power BI 获取数据对话框中选择其他类别下的 ODBC 选项

从列表中选择您之前创建的数据源。

ODBC 驱动程序选择对话框显示配置的 ClickHouse DSN

备注

如果您在数据源创建过程中未指定凭据,则会提示您输入用户名和密码。

ODBC DSN 连接的凭据对话框

最后,您应该在导航器视图中看到数据库和表。选择所需的表并单击 "加载" 以从 ClickHouse 导入数据。

Power BI 导航器视图显示 ClickHouse 数据库表和示例数据

导入完成后,您的 ClickHouse 数据应在 Power BI 中如常访问。

已知限制

UInt64

无符号整数类型如 UInt64 或更大的类型不会自动加载到数据集中,因为 Int64 是 Power BI 支持的最大整数类型。

备注

要正确导入数据,在点击 "加载" 按钮之前,请先点击 "转换数据"。

在此示例中,pageviews 表具有一个 UInt64 列,该列默认被识别为 "二进制"。 "转换数据" 将打开 Power Query 编辑器,在这里我们可以重新分配该列的类型,例如设置为文本。

Power Query 编辑器显示 UInt64 列的数据类型转换

完成后,点击左上角的 "关闭并应用",然后继续加载数据。