将 ClickHouse 连接到 Deepnote

在熟悉的笔记本环境中高效查询超大规模数据集，并轻松进行分析和建模。

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

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

​

交互式示例

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

​

连接到 ClickHouse

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

2. 填写 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：

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

如果你使用的是自管理 ClickHouse，则连接信息由你的 ClickHouse 管理员配置。

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

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

​

使用 ClickHouse 集成

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

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

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