概览
- 查询语言
- etcdctl
- 驱动
- 首次使用时下载
- 连接方式
- 主机和端口, SSH 隧道, SSL/TLS
- 默认端口
- 2379
- 最低版本
- 3.2


连接
输入一个主机及其客户端端口;对等端口没有 JSON 网关,也不提供数据库选择或端点故障转移。在未启用认证的集群上,请将 用户名 (Username) 和 密码 (Password) 留空。没有 root 角色的用户可浏览其角色覆盖的键,但 endpoint status 以及 user 和 role 命令会返回权限拒绝。
TLS 通过 Advanced 字段中的 TLS 模式 (TLS Mode) 设置,默认为 Disabled。Required (skip verify) 加密但不验证,Verify CA 对照您指定的 CA 文件验证证书,Verify Identity 还会检查主机名;客户端证书和密钥提供双向 TLS。可导入 etcd:// 和 etcds:// URL,两者都不会自行开启 TLS。
浏览键和运行命令
设置 键前缀根 (Key Prefix Root),例如 /app,可将连接限定在一个子树。侧边栏按其下的第一个路径段对键分组,每个键为一行,显示其值、版本、修改和创建修订号以及租约。
保存编辑会发送命令:新值或租约会重新 put 该键,NULL 租约会移除租约,重命名会 put 新名称并删除旧名称。修订号列由 etcd 管理,因此编辑其中一列会停止保存并指出列名。
运行 etcdctl 风格的键、watch、租约、成员、端点、压缩和访问控制命令,支持命令和标志补全;不支持的命令会在发送到服务器前被拒绝。Safe Mode 将 get、watch 以及只列出或报告信息的命令作为读取运行,其他命令均视为写入。
租约和集群
在编辑器中管理租约和修订压缩,并通过命令查看成员以及端点状态或健康情况。运行 auth enable 会为整个集群开启认证:保存了用户名和密码的连接继续工作,两者都没有的连接需带凭据重新打开。
本页介绍 etcd 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。
其他
移动数据
将键或命令结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。
限制
- 不支持 txn。
- 连接使用 v3 JSON 网关,不使用 gRPC。
- watch 收集事件至超时,然后按行显示。
为什么租约 ID 指向另一个租约?
租约 ID 接受十进制或十六进制,十六进制通过其中的字母识别。纯数字的十六进制 ID 请加上
0x前缀,例如--lease=0x69407712,否则会按十进制解析,指向另一个租约。可以编辑二进制值吗?
不可以。不是有效 UTF-8 的值会在网格中以 base64 显示并加以标注,您输入的文本以 UTF-8 发送。请用
etcdctl写入二进制值。