如何通过etcdctl按指定层级列出etcd前缀键？

etcdctl本身没有原生的“按层级筛选键”的专用参数，但可以结合etcd的范围查询特性和轻量shell工具实现需求，避免全量导出后再做大量处理：

1. 仅列出顶层键（如/foo、/sol） #

利用etcd键的字典序特性，先查询所有以/开头的键，再过滤出仅包含单个层级的键：

# 确保使用v3 API
export ETCDCTL_API=3

# 方法1：范围查询+正则过滤
etcdctl get / --to-key='/\xff' --keys-only | grep -E '^/[^/]+$' | sort -u

# 方法2：前缀查询+awk提取层级
etcdctl get / --prefix --keys-only | awk -F '/' '{if(NF==2) print "/"$2}' | sort -u

• --to-key='/\xff'：限定查询范围为所有以/开头的键（\xff是ASCII最大值，确保覆盖所有以/开头的键）
• grep -E '^/[^/]+$'：只保留格式为/xxx的顶层键
• sort -u：去重并排序

2. 列出前两层键（如/foo/bar、/sol/bar） #

同样通过层级过滤实现，或分两步查询减少数据传输：

方法1：直接过滤两层键 #

etcdctl get / --prefix --keys-only | awk -F '/' '{if(NF==3) print "/"$2"/"$3}' | sort -u

• NF==3：对应/xxx/yyy格式的两层键

方法2：先查顶层键，再逐个查询下一层（适合大型集群） #

这种方式每次查询范围更小，减少从etcd获取的数据量：

export ETCDCTL_API=3

# 先获取所有顶层键
for top_key in $(etcdctl get / --to-key='/\xff' --keys-only | grep -E '^/[^/]+$'); do
  # 查询该顶层键下的直接子键（仅下一层）
  etcdctl get "$top_key/" --prefix --keys-only | grep -E "^$top_key/[^/]+$" | sort -u
done

• "$top_key/"：确保查询的是该顶层键下的子键前缀
• grep -E "^$top_key/[^/]+$"：只保留该顶层键下的直接子键，不包含更深层级

内容的提问来源于stack exchange，提问作者Rino Bino