get_table_records
Query data table records by applying filters, sorting, pagination, and field projection.
Instructions
查询数据表的记录列表，支持过滤、排序、分页和字段投影
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tableName | Yes | 表名称(不是ID) | |
| filter | No | 查询过滤条件，类似于关系库的where参数。第一级的key可以是字段名称或者or等特殊参数。 - 字段名称支持完全匹配和模糊搜索 - or表示多个条件中满足其中一个即可 - 示例1（完全匹配）: {"status": "online", "type": "sensor"} - 示例2（模糊搜索）: {"name": {"$regex": "设备", "$options": "i"}} - 示例3（or条件）: {"$or": [{"status": "online"}, {"type": "sensor"}]} - 示例4（组合查询）: {"status": "online", "$or": [{"type": "sensor"}, {"type": "controller"}]} | |
| sort | No | 排序条件，类似于关系库的order by参数。格式{key:value}，key是需要排序的字段名称，value是1和-1，1表示升序，-1表示降序。 - 可以同时按照多个字段排序，排序优先级按照字段顺序 - 示例1（单字段升序）: {"createTime": 1} - 示例2（单字段降序）: {"createTime": -1} - 示例3（多字段排序）: {"status": 1, "createTime": -1} (先按status升序，相同值按createTime降序) | |
| limit | No | 分页查询参数，指定返回的记录数量限制，格式{key:value}，key是limit，value是实际值。类似于关系库的LIMIT语句。 | |
| skip | No | 分页查询参数，指定跳过的记录数量，用于分页，格式{key:value}，key是skip，value是实际值。类似于关系库的OFFSET语句。 | |
| project | No | 字段投影，指定需要查询返回的字段，格式{key:value}，key是字段名称，value是1表示包含该字段。 - 示例: {"name": 1, "status": 1, "createTime": 1} 只返回name、status和createTime字段 | |
| withCount | No | 总条数统计参数，格式{key:value}，key是固定值withCount，value是true。会在响应头加上count字段，对应值为总条数。 - 示例: {"withCount": true} |