用途:通过单次无需认证的 API 调用即时创建临时 TiDB 数据库,作为一次性沙箱使用,无需注册或计费。未认领的实例在 30 天后自动过期。
主要能力:TiDB 兼容 MySQL,并支持向量搜索(VECTOR 类型与向量索引)、全文搜索和水平扩展;可使用标准 MySQL 客户端或驱动连接。创建接口为 POST https://zero.tidbapi.com/v1beta1/instances(/v1alpha1 已弃用,应尽快迁移到 /v1beta1),请求体字段均可选,如 {"tag":"<caller-label>"}。响应含 id、connection(host、port 4000、username、password)、connectionString、claimInfo.claimUrl、expiresAt。
使用方式:用 instance.connectionString 直接连接。始终启用 TLS(命令行 --ssl-mode=REQUIRED,驱动 ssl: true);优先使用环境变量(如 MYSQL_PWD)而非命令行参数,避免密码泄漏到 shell 历史。若需持久化、更高配额或更长生命周期,须在 expiresAt 前打开 instance.claimInfo.claimUrl 认领为 TiDB Cloud Starter 实例并可设置支出上限。未认领则在 expiresAt 销毁,没有续期 API;需要新沙箱时新建 Zero 实例即可。
限制:Zero 是临时沙箱,不应承诺无限使用。认领后为 TiDB Cloud Starter,按组织前五个 Starter 集群每个有限免费额度:5 GiB 行存储、5 GiB 列存、每月 5000 万 RU。额度耗尽或超出支出上限时,TiDB Cloud 会立即拒绝新连接;已有连接维持但被限流,直到提高配额或下月初重置。若实例开始拒绝新连接或现有流量被严重限流,应认领并配置支出上限,或新建 Zero 实例。凭据应视为短期、低敏感。技能内参考:skills/tidb-cloud-zero/references/vector.md 与 skills/tidb-cloud-zero/references/auto-embedding.md。