将 ClickHouse 连接到 Deepnote

Community Maintained

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

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

交互式示例

如果您想体验一个在 Deepnote 数据 notebook 中查询 ClickHouse 的交互式示例，请点击下方按钮，启动一个已连接到 ClickHouse playground 的模板项目。

连接到 ClickHouse

1. 在 Deepnote 中，选择“Integrations”概览，然后点击 ClickHouse 卡片。

2. 填写您的 ClickHouse 实例连接信息：

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

参数	说明
HOST 和 PORT	通常，在使用 TLS 时端口为 8443，不使用 TLS 时端口为 8123。
DATABASE NAME	默认提供一个名为 default 的数据库，请填写您要连接的目标数据库名称。
USERNAME 和 PASSWORD	默认用户名为 default。请使用适合您使用场景的用户名。

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择某个服务并点击 Connect：

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

如果您使用的是自托管 ClickHouse，则连接信息由您的 ClickHouse 管理员进行设置。

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

3. 恭喜！您已成功将 ClickHouse 集成到 Deepnote 中。

使用 ClickHouse 集成

1. 首先，连接到 notebook 右侧的 ClickHouse 集成。

   

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

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