用途:管理 PlanetScale Postgres 分支的 Database Traffic Control 预算与规则。先做只读盘点并结合 Insights 证据,未经明确批准不得创建、更新、删除预算或启用 enforce。
主要能力:列出预算及内嵌规则元数据;按精确 Insights fingerprint 查找包含对应规则的预算;展示单个预算及其规则;创建、更新、删除预算;创建按精确 fingerprint、keyspace 或 tag 匹配的规则并删除已复核规则。该命令族仅适用于 Postgres,建议使用 JSON 输出,避免 ID、可空限制、模式与嵌套规则被截断。
使用方式:常用只读命令如 pscale traffic-control budget list <database> <branch> --org <org> --format json、budget show,以及 rule create 时指定 --fingerprint、--keyspace 或可重复的 --tag(source 默认 sql)。创建预算需 --name,默认 mode 为 warn;更新只发送显式提供的参数,需区分省略与显式 0。每次写入后应重新执行 budget show 与 budget list 核对返回字段。
适用场景:为特定流量类别设置稳定、有界的 tag 规则;对已知查询形态用精确 fingerprint 做遏制;先在 warn 模式观察警告与误报,经明确批准后再切到 enforce。
限制:Traffic Control 是数据库资源护栏,不能替代查询调优、应用层限流、工作负载隔离或故障诊断;enforce 会拒绝匹配查询并改变应用行为。删除预算或规则、使用 --force 都需事先批准。空过滤列表只说明当前没有预算包含该精确 fingerprint 的规则,并不代表查询无害,也不排除 tag 或 keyspace 规则的影响。避免使用请求 ID、用户 ID、邮箱、UUID、原始 URL 等无界值作为 tag。资料未提供收费、价格、平台支持范围等更多信息。