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

将 ClickHouse 连接到 Deepnote

Community Maintained

Deepnote 是一个协作数据笔记本，旨在帮助团队发现和分享洞察。除了与 Jupyter 兼容之外，它还在云端工作，为您提供一个集中地点，以高效地协作和处理数据科学项目。

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

交互式示例​

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

连接到 ClickHouse​

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

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

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

  • 数据库名称：默认情况下，有一个名为 default 的数据库，请使用您要连接的数据库名称。

  • 用户名和密码：默认情况下，用户名为 default。请使用适合您用例的用户名。

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

选择 HTTPS，并且详细信息可以在一个示例 curl 命令中找到。

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

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

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

使用 ClickHouse 集成​

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

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

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