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

将 ClickHouse 连接到 Deepnote

Community Maintained

Deepnote 是一个为团队构建的协作数据笔记本，使数据洞察的发现与分享变得更加高效。除了兼容 Jupyter，它还在云端运行，为您提供一个集中协作和高效工作于数据科学项目的地方。

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

交互示例​

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

在 Deepnote 中启动

连接到 ClickHouse​

  1. 在 Deepnote 中，选择 "Integrations" 概览并点击 ClickHouse 瓷砖。
ClickHouse 集成瓷砖
  1. 提供您的 ClickHouse 实例的连接详细信息：

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

  • 主机和端口：通常，当使用 TLS 时端口为 8443，当不使用 TLS 时端口为 8123。

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

  • 用户名和密码：开箱即用时，用户名为 default。请使用适合您用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可在 ClickHouse Cloud 控制台中获得。 选择您要连接的服务并点击 连接：

ClickHouse Cloud 服务连接按钮

选择 HTTPS，详细信息可在示例的 curl 命令中获得。

ClickHouse Cloud HTTPS 连接详细信息

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

ClickHouse 详细信息对话框

注意： 如果您的 ClickHouse 连接受 IP 访问列表保护，您可能需要允许 Deepnote 的 IP 地址。有关更多信息，请参阅 Deepnote 的文档。

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

使用 ClickHouse 集成​

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

    ClickHouse 详细信息对话框

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

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