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

将 ClickHouse 连接到 Deepnote

Deepnote 是一个协作式数据笔记本,专为团队发现和分享见解而构建。除了兼容 Jupyter 之外,它还在云端运行,并为您提供一个集中的场所,以便高效地协作和处理数据科学项目。

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

交互式示例

如果您想探索从 Deepnote 数据笔记本查询 ClickHouse 的交互式示例,请单击下面的按钮启动连接到 ClickHouse Playground 的模板项目。

连接到 ClickHouse

  1. 在 Deepnote 中,选择“集成”概述,然后单击 ClickHouse 磁贴。
ClickHouse integration tile
  1. 提供您的 ClickHouse 实例的连接详细信息

要使用 HTTP(S) 连接到 ClickHouse,您需要以下信息

  • 主机和端口:通常,使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。

  • 数据库名称:开箱即用,有一个名为 default 的数据库,请使用您要连接的数据库的名称。

  • 用户名和密码:开箱即用,用户名是 default。请使用适合您用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可在 ClickHouse Cloud 控制台中找到。选择您要连接的服务,然后单击连接

ClickHouse Cloud service connect button

选择 HTTPS,详细信息在示例 curl 命令中提供。

ClickHouse Cloud HTTPS connection details

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

ClickHouse details dialog

注意: 如果您的 ClickHouse 连接受到 IP 访问列表的保护,您可能需要允许 Deepnote 的 IP 地址。有关更多信息,请阅读 Deepnote 的文档。 3. 恭喜!您现在已将 ClickHouse 集成到 Deepnote 中。

使用 ClickHouse 集成。

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

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

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