360 Secure SkillHub
360 安全技能中心

TiDB Cloud Zero

该 Skill 指导用一次未鉴权的 HTTP 请求创建 TiDB Cloud Zero 临时实例，获得 MySQL 兼容的主机、端口、用户名、密码与连接字符串；实例默认 30 天后自动过期，未认领即销毁，也可在到期前认领转为常规实例。文内附向量检索与自动嵌入参考文档，说明在 SQL 中使用相关能力。

zoubingwu
zoubingwu
热度 72.83
最近更新 2026-05-11 17:27:43
分类：开发依赖：第三方 API / 代码执行应用场景：API 集成 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add tidb-cloud-zero
Metadata
name
tidb-cloud-zero
description
Provision a disposable MySQL-compatible database instantly for free, no auth required. Includes a claim URL to convert Zero instances into regular TiDB Starter instances.
compatibility
Requires a MySQL-compatible client or driver (e.g. mysql CLI, mysql2, PyMySQL) and network access to zero.tidbapi.com.
metadata
{"version":"1.3.0","homepage":"https://zero.tidbcloud.com/"}

TiDB Cloud Zero

Provisions an ephemeral TiDB database via a single unauthenticated API call. No sign-up, no billing. Instances auto-expire in 30 days unless claimed.

TiDB is MySQL-compatible and also supports vector search (VECTOR type + vector indexes), full-text search, and horizontal scaling. Use standard MySQL clients/drivers to connect.

Important Notes

  • The API is unauthenticated and free. Instances auto-expire — treat credentials as short-lived and low-sensitivity.
  • Prefer environment variables (e.g. MYSQL_PWD) over CLI arguments to avoid leaking passwords in shell history.
  • Always connect with TLS (--ssl-mode=REQUIRED for CLI, ssl: true for drivers).
  • If the user wants to keep the instance, open instance.claimInfo.claimUrl before expiresAt to convert it into a regular TiDB Starter instance.

API

POST https://zero.tidbapi.com/v1beta1/instances

/v1alpha1 is deprecated. You should migrate to /v1beta1 as soon as possible.

Content-Type: application/json

Request body (all fields optional):

{ "tag": "<caller-label>" }

Response:

{
  "instance": {
    "id": "...",
    "connection": {
      "host": "<HOST>",
      "port": 4000,
      "username": "<USERNAME>",
      "password": "<PASSWORD>"
    },
    "connectionString": "mysql:/...",
    "claimInfo": {
      "claimUrl": "https://tidbcloud.com/tidbs/claim/..."
    },
    "expiresAt": "<ISO_TIMESTAMP>"
  }
}

Use instance.connectionString for immediate driver connections. If persistence is needed, ask the user to open instance.claimInfo.claimUrl before expiresAt to claim it. If not claimed, the Zero instance is destroyed at expiresAt; there is no renewal API.

Use these references (inside this skill)

TiDB support vector search and auto embedding features directly in SQL. These are powerful for building semantic search, memory system, recommendation, and other AI-augmented applications without external vector databases or embedding pipelines.

  • skills/tidb-cloud-zero/references/vector.md - vector features and step-by-step vector SQL usage.
  • skills/tidb-cloud-zero/references/auto-embedding.md - auto-embedding features and step-by-step SQL usage.

Resources