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

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 要求您在桌面版本中创建仪表板，然后将其发布到 Power BI Service。

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

Prerequisites​

Power BI Installation​

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

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

Gather your ClickHouse connection details​

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

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

Power BI Desktop​

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

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

Install the ODBC Driver​

下载最新的 ClickHouse ODBC 版本。

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


备注

Debug symbols 是可选的，不是必需的

Verify ODBC Driver​

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

在开始菜单中搜索 ODBC，然后选择“ODBC 数据源 (64-bit)”。


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


Find the ClickHouse Connector​

备注

在 Power BI Desktop 的版本 2.137.751.0 中可用

在 Power BI Desktop 启动屏幕上，单击“获取数据”。


搜索“ClickHouse”


Connect to ClickHouse​

选择连接器，并输入 ClickHouse 实例凭据：

  • 主机 (必填) - 您的实例域名/地址。确保不添加前缀/后缀。
  • 端口 (必填) - 您的实例端口。
  • 数据库 - 您的数据库名称。
  • 选项 - 任意 ODBC 选项，如 在 ClickHouse ODBC GitHub 页面 中列出的
  • 数据连接模式 - DirectQuery

备注

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

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

  • 指定用户名和密码

Query and Visualise Data​

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


导入完成后，您的 ClickHouse 数据应该像往常一样可以在 Power BI 中访问。


Power BI Service​

为了使用 Microsoft Power BI Service，您需要创建一个 本地数据网关。

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

ODBC Driver (Import Only)​

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

在本地数据网关实例上安装 ODBC 驱动程序，并按照上述步骤 验证。

Create a new User DSN​

当驱动程序安装完成后，可以创建 ODBC 数据源。搜索 ODBC 在开始菜单中，然后选择“ODBC 数据源 (64-bit)”。


我们需要添加一个新的用户 DSN。单击左侧的“添加”按钮。


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


填写连接详细信息。


备注

如果您使用的是启用了 SSL 的部署（例如 ClickHouse Cloud 或自管理的实例），在 SSLMode 字段中应提供 require。

  • Host 应始终省略协议（即 http:// 或 https://）。
  • Timeout 是一个表示秒数的整数。默认值：30 seconds。

Get Data Into Power BI​

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

在 Power BI Desktop 启动屏幕上，单击“获取数据”。


选择“其他” -> “ODBC”。


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


备注

如果您在数据源创建期间没有指定凭据，系统将提示您指定用户名和密码。


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


导入完成后，您的 ClickHouse 数据应该像往常一样可以在 Power BI 中访问。

Known Limitations​

UInt64​

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

备注

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

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


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