教程：连接 Lakehouse
云器 Lakehouse 支持多种连接方式，从命令行到编程接口，满足不同场景的接入需求。下面根据你的角色和技术偏好，帮你选择最合适的连接方式。
连接方式速览
| 连接方式 | 适用场景 | 推荐人群 |
|---|---|---|
| cz-cli 命令行工具 | 终端操作 SQL、管理任务、Agent 集成 | 数据工程师、AI Agent 开发者 |
| JDBC 驱动 | Java/Scala 应用、BI 工具直连 | 应用开发者、BI 工程师 |
| 命令行客户端（sqlline） | 基于 Java 的交互式 SQL 终端 | 习惯传统数据库终端的技术人员 |
| MySQL 协议 | 兼容 MySQL 生态的工具（Navicat、DataGrip 等） | 数据分析师、DBA |
| SQLAlchemy | Python 数据应用、Jupyter Notebook | Python 开发者、数据科学家 |
按角色选择
数据工程师 / 终端用户
推荐 cz-cli——一次配置 Profile，后续所有 SQL 和任务操作自动使用同一套连接参数，无需每次输入 JDBC URL。
Java/Scala 应用开发者
推荐 JDBC 驱动——标准数据库连接接口，可直接集成到 Spring、Flink 等框架中。
→ JDBC 驱动
Python 开发者 / 数据科学家
推荐 SQLAlchemy——Python 生态中标准的数据库抽象层，支持 ORM 和原生 SQL，适合 Jupyter Notebook 分析场景。
BI 工具 / 数据库管理工具用户
Lakehouse 兼容 MySQL 协议，Navicat、DataGrip、DBeaver 等工具可以直接连接，像操作 MySQL 一样操作 Lakehouse。
习惯传统数据库终端的技术人员
sqlline 基于 Java 的交互式 SQL 终端，输入 SQL 后实时返回结果，适合快速查询和数据探索。
客户端下载
所有客户端驱动和工具包的下载链接，详见 相关下载。
连接参数通用说明
无论哪种连接方式，都需要以下核心信息：
| 参数 | 说明 | 获取方式 |
|---|---|---|
| Service Endpoint | 服务端点地址 | 参考 各云地域端点 |
| Instance ID | 实例标识 | Studio 首页左上角 |
| Workspace | 工作空间名称 | Studio 顶部下拉框 |
| Schema | 默认 Schema | 连接后 |
| VCluster | 计算集群名称 | 连接后 |
| 用户名 / 密码 | 认证凭证 | 平台注册账号 |
联系我们