TiDB Cloud Lake 常见问题¶
账号与 Lake DSN¶
没有 TiDB Cloud 账号怎么办？¶
前往注册 TiDB Cloud。完成注册和首次认证后，系统将进入 TiDB Cloud Lake，并打开 Connect。复制 LakeSQL DSN 后返回观测云继续配置。
找不到 Connect 或 Lake DSN¶
- 确认当前进入的是 TiDB Cloud Lake；
- 在 Lake 页面打开 Connect；
- 在连接示例中选择 LakeSQL，不要复制 Python、Golang 等其他示例；
- 确认 DSN 同时包含 Database 和
warehouse参数。
完整步骤见注册 TiDB Cloud 并获取 Lake DSN。
Lake DSN 格式错误或无法解析 Database、Warehouse¶
请重新从 Connect 页面复制完整 DSN，不要手动删除或改写其中的内容。格式应类似：
如果密码包含特殊字符，请优先使用 TiDB Cloud Lake 页面生成的 DSN，避免手动拼接导致编码错误。
连接与认证¶
提示认证失败¶
可能原因包括 SQL 用户或密码错误、密码已更新、用户已停用。请在 TiDB Cloud Lake 中确认账号状态，重新获取 DSN，然后更新观测云中的配置。
提示无法连接 TiDB Cloud Lake¶
请依次检查：
- DSN 的 Endpoint 和 Port 是否完整；
- 目标 Warehouse 是否可用；
- TiDB Cloud Lake 服务是否正常；
- 网络策略是否允许观测云服务访问 Lake；
- 稍后重新执行测试连接，排除临时网络或 Warehouse 不可用。
修改密码后需要做什么？¶
需要重新复制 Lake DSN，并分别更新所有使用旧密码的外部数据源和数据转发规则。两项功能独立保存配置，不会自动同步更新。
外部数据源与查询¶
连接成功，但查询提示没有权限¶
连接成功仅代表 DSN 和基础连接有效。请确认 SQL 用户具有目标 Database、Schema 和 Table 的只读查询权限，同时确认当前观测云成员具有该外部数据源的使用权限。
在查询数据源列表中看不到 Lake 数据源¶
请确认：
- 数据源已保存且未删除；
- 当前成员具有该数据源的使用权限；
- 当前页面支持外部数据源查询；
- 筛选或搜索条件没有隐藏该数据源。
为什么写入型 SQL 无法执行？¶
为保护 Lake 数据，外部数据源查询仅支持单条只读 SELECT、WITH ... SELECT 或 EXPLAIN。写入、删除、DDL、事务和多语句会被服务端拒绝。需要写入观测数据时，请使用数据转发至 TiDB Cloud Lake。
查询超时或返回数量超过限制¶
单次查询默认超时 60 秒，最多返回 10,000 行。请缩小时间范围、增加 WHERE 条件、减少扫描表或添加 LIMIT。
数据转发¶
测试连接成功，为什么没有创建目标表？¶
测试连接会验证 Lake DSN、Database、Warehouse、目标表是否存在，以及相关写入或建表权限，并提供对应的检查结果，但不会创建表。目标表不存在时，系统会在完成规则创建时按当前转发数据类型的托管结构执行建表操作。
测试连接或完成规则时提示没有写入或建表权限¶
- 目标表已存在：SQL 用户需要目标表写入权限；
- 目标表不存在：SQL 用户还需要在目标 Database 中创建表的权限。
调整权限后重新测试连接，再完成规则创建。
如果目标表的写入权限或表结构检查失败，或者系统创建目标表失败，规则仍会启用，并在规则列表中显示【！】提示。请根据提示修复权限、表结构或建表问题，确保后续批次能够写入目标表。
提示目标表结构不兼容¶
已有目标表必须与当前转发数据类型的系统托管结构兼容。建议使用新的表名，让系统在完成规则创建时自动创建；如需使用已有表，请先根据错误提示调整表结构。
规则已启用，但暂时查不到数据¶
数据转发会按照所选数据等待时间封存 Parquet Batch 并加载到 Lake，因此不是逐条实时写入。请检查：
- 是否有数据命中规则的数据类型与过滤条件；
- 是否已超过所选的 15 分钟、30 分钟或 1 小时等待时间；
- 规则和加载批次是否显示失败；
- 查询使用的 Database 和 Target Table 是否与规则一致。
为什么不需要填写 Bucket、存储路径或 IAM 凭据？¶
TiDB Cloud Lake 转发使用观测云托管的中转存储与对象路径。用户只需要提供 Lake DSN 和 Target Table；Bucket、对象路径和中转访问凭据由系统维护。
安全排查¶
提交问题时可以提供哪些信息？¶
可以提供：
- 数据源名称或转发规则名称；
- 脱敏后的 Endpoint、Database、Warehouse 和 Target Table；
- 失败时间、错误码和页面错误信息；
- SQL 指纹或去除敏感条件后的查询结构。
请勿提供完整 Lake DSN、SQL 用户密码、内部 Bucket、临时凭据或包含敏感数据的完整查询结果。