数据查询工具 前置要求 需要环境变量(脚本会自动读取,若读取不到需提醒用户设置): - (或 ) - (或 ) 工作流程(严格按顺序执行) 第一步:查询可用数据源(必须先执行) 在构造任何查询之前, 必须先调用此步骤 了解有哪些数据源及其字段定义。这一步的作用是:确认用户需要的数据存在于哪个数据源中,以及该数据源有哪些字段和过滤规则。跳过这一步直接去猜字段名几乎一定会出错。 返回内容包含: - :数据源唯一标识 - :数据源中文名称 - :数据源说明 - :所有字段列表,每个字段包含 field(字段名)、label(显示名)、type(类型)、description(描述)、filterable(是否可作为过滤条件字段) - :使用备注 关键:根据返回的字段信息(尤其是 field 名称和 type 类型),确定需要用到的字段和过滤操作符,再进入第二步。 字段类型与操作符对照表 每种字段类型只支持特定操作符。用错操作符会直接报错,所以在构造 filters 之前请务必对照此表。 | 字段类型 | 支持的操作符 | 说明 | |---------|------------|------| | | , , | 精确匹配类字段(如编码、状态、类型) | | | , | 文本类字段(如名称、地址、描述),支持模糊搜索 | | / | , | 日期类字段,范围查询用 between |…