使用 SDK
接收应用输入
将应用中的选项映射到允许的操作，并将查询值与语法分开处理。
把用户选项转换成查询，再按应用自己的方式保存和执行。构建阶段不需要数据库连接，执行阶段只需要查询文本。
正在加载图示…
flowchart LR
accTitle: 查询的构建、保存与执行
accDescr: 应用校验输入，MetriCraft 构建字符串，应用保存并读取字符串，客户端向后端发送查询。
subgraph build["1. 构建并保存"]
direction TB
ui["界面选项"] --> policy["应用校验与权限"] --> builder["MetriCraft 构建器"]
builder --> query["查询字符串"] --> storage[("应用存储")]
end
subgraph execute["2. 读取并执行"]
direction TB
load["应用读取查询"] --> client["MetriCraft HTTP 客户端"] --> backend[("Prometheus / VictoriaMetrics")]
end
build --> execute构建器只生成查询字符串；保存与读取由应用负责，查询求值由后端负责。两个阶段可以分开运行。
- 应用负责：允许的指标、标签、操作、权限和成本限制，以及 YAML/XML/数据库中的保存与读取。选项变化时，从合适的基础表达式重新派生。
- 构建器负责：验证表达式结构、名称、时长与函数目录；转义标签值和字符串参数。重复匹配器按逻辑与组合，不会覆盖已有租户等约束。正则仍有正则语义，其成本由应用与后端负责。
- 客户端负责：将查询交给后端，提供同步/异步查询、元数据、写入、自定义传输、结果模型和集群路由。先按目标方言构建并保存文本；读取后执行时，不会重新选择方言或验证文本。
构建保证只适用于结构化输入。构建器没有原始表达式插入口；客户端不会解析、清理或修复任意查询字符串。保存后的编辑、完整性和授权由应用负责。