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

将 ClickHouse 连接到 Deepnote

Community Maintained

Deepnote 是一个协作数据笔记本,旨在帮助团队发现和分享洞察。除了与 Jupyter 兼容之外,它还在云端工作,为您提供一个集中地点,以高效地协作和处理数据科学项目。

本指南假设您已经有一个 Deepnote 账户,并且您有一个正在运行的 ClickHouse 实例。

交互式示例

如果您想探索通过 Deepnote 数据笔记本查询 ClickHouse 的交互式示例,请点击下面的按钮以启动一个连接到 ClickHouse playground 的模板项目。

Launch in Deepnote

连接到 ClickHouse

  1. 在 Deepnote 中,选择“集成”概述并点击 ClickHouse 瓷砖。
ClickHouse integration tile
  1. 提供您的 ClickHouse 实例的连接详细信息:

要通过 HTTP(S) 连接到 ClickHouse,您需要以下信息:

  • HOST 和 PORT:通常情况下,使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。

  • 数据库名称:默认情况下,有一个名为 default 的数据库,请使用您要连接的数据库名称。

  • 用户名和密码:默认情况下,用户名为 default。请使用适合您用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中找到。选择您要连接的服务并点击 Connect

ClickHouse Cloud service connect button

选择 HTTPS,并且详细信息可以在一个示例 curl 命令中找到。

ClickHouse Cloud HTTPS connection details

如果您使用自管理的 ClickHouse,连接详细信息由您的 ClickHouse 管理员设置。

ClickHouse details dialog

注意: 如果您的 ClickHouse 连接受 IP 访问列表保护,您可能需要允许 Deepnote 的 IP 地址。请在 Deepnote 的文档 中了解更多信息。

  1. 恭喜!您现在已经将 ClickHouse 集成到 Deepnote 中。

使用 ClickHouse 集成

  1. 首先,连接到您笔记本右侧的 ClickHouse 集成。

    ClickHouse details dialog
  2. 现在创建一个新的 ClickHouse 查询块并查询您的数据库。查询结果将作为 DataFrame 保存,并存储在 SQL 块中指定的变量中。

  3. 您还可以将任何现有的 SQL 块 转换为 ClickHouse 块。