跳至主要内容

将 ClickHouse 连接到 Deepnote

Deepnote 是一款为团队构建的协作数据笔记本，用于发现和分享见解。除了与 Jupyter 兼容之外，它还在云中运行，并为您提供一个中心位置，以高效地协作和处理数据科学项目。

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

交互式示例​

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

连接到 ClickHouse​

  1. 在 Deepnote 中，选择“集成”概述，然后单击 ClickHouse 磁贴。
ClickHouse integration tile

  1. 提供 ClickHouse 实例的连接详细信息

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

    • HOST 和 PORT：通常，使用 TLS 时端口为 8443，不使用 TLS 时端口为 8123。

    • DATABASE NAME：默认情况下，存在一个名为 default 的数据库，请使用要连接到的数据库的名称。

    • USERNAME 和 PASSWORD：默认情况下，用户名为 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 文档。

  2. 恭喜！您现在已将 ClickHouse 集成到 Deepnote 中。

使用 ClickHouse 集成。​

  1. 从笔记本右侧的 ClickHouse 集成开始连接。

    ClickHouse details dialog

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

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