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