Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

将 ClickHouse 连接到 Deepnote

由社区维护

Deepnote 是一个面向团队的协作式数据 笔记本,用于帮助团队发现并共享洞察。除了兼容 Jupyter 之外,它还支持在云端运行,并为你提供一个统一的平台,以便高效协作和开展数据科学项目。

本指南假定你已拥有 Deepnote 账户,并且已有一个正在运行的 ClickHouse 实例。

交互式示例

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

在 Deepnote 中启动

连接到 ClickHouse

  1. 在 Deepnote 中,选择“Integrations”概览,然后点击 ClickHouse 卡片。
ClickHouse 集成卡片
  1. 填写 ClickHouse 实例的连接信息:

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

Parameter(s) Description
HOST and PORT 通常,使用 TLS 时端口为 8443;不使用 TLS 时端口为 8123。
DATABASE NAME 默认情况下,存在一个名为 default 的数据库。请使用你要连接的数据库名称。
USERNAME and PASSWORD 默认情况下,用户名为 default。请根据你的使用场景使用相应的用户名。

你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。 选择一个服务,然后点击 Connect:

ClickHouse Cloud 服务连接按钮

选择 HTTPS。连接信息会显示在示例 curl 命令中。

ClickHouse Cloud HTTPS 连接信息

如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。

详情对话框

注意: 如果您与 ClickHouse 的连接受 IP Access List 保护,可能需要将 Deepnote 的 IP 地址加入允许列表。更多信息请参阅 Deepnote 文档。

  1. 恭喜!您已成功将 ClickHouse 集成到 Deepnote 中。

使用 ClickHouse 集成。

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

    详情对话框
  2. 现在,新建一个 ClickHouse 查询块,并查询你的数据库。查询结果将保存为 DataFrame,并存储在 SQL 块中指定的变量中。

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

Navigation