> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> 在熟悉的笔记本环境中高效查询超大规模数据集，并轻松进行分析和建模。
# 将 ClickHouse 连接到 Deepnote
export const CommunityMaintainedBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
Deepnote 是一个面向团队的协作式数据 笔记本，用于帮助团队发现并共享洞察。除了兼容 Jupyter 之外，它还支持在云端运行，并为你提供一个统一的平台，以便高效协作和开展数据科学项目。
本指南假定你已拥有 Deepnote 账户，并且已有一个正在运行的 ClickHouse 实例。
## 交互式示例
如果你想查看一个通过 Deepnote 数据笔记本查询 ClickHouse 的交互式示例，请点击下方按钮，启动一个连接到 [ClickHouse playground](/zh/get-started/sample-datasets/playground) 的模板项目。
[
](https://deepnote.com/launch?template=ClickHouse%20and%20Deepnote)
## 连接到 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 文档](https://docs.deepnote.com/integrations/authorize-connections-from-deepnote-ip-addresses)。
3. 恭喜！您已成功将 ClickHouse 集成到 Deepnote 中。
## 使用 ClickHouse 集成
1. 首先，连接到 笔记本 右侧的 ClickHouse 集成。
2. 现在，新建一个 ClickHouse 查询块，并查询你的数据库。查询结果将保存为 DataFrame，并存储在 SQL 块中指定的变量中。
3. 你也可以将任何现有的 [SQL 块](https://docs.deepnote.com/features/sql-cells) 转换为 ClickHouse 块。