OData V4.01 完整查询语法速查表
适用版本：OData V4.0 / V4.01（主流企业级标准）
核心原则：所有系统查询选项均以$ 开头，多个选项用& 分隔，大小写敏感；URL 中特殊字符需进行百分号编码
一、基础查询选项速查
查询选项 | 语法 | 功能说明 | 标准示例 |
$select | $select=属性1,属性2,... | 指定返回的属性，减少数据传输量 | Books?$select=Id,Title,Price |
$filter | $filter=条件表达式 | 按条件筛选数据 | Books?$filter=Price lt 50 |
$orderby | $orderby=属性1 [asc/desc],属性2 [asc/desc] | 对结果排序，默认升序asc | Books?$orderby=Price desc,PublishDate asc |
$top | $top=N | 返回前 N 条记录 | Books?$top=10 |
$skip | $skip=N | 跳过前 N 条记录（配合$top实现客户端分页） | Books?$skip=20&$top=10（第 3 页，每页 10 条） |
$count | $count=true | 同时返回匹配条件的总记录数 | Books?$filter=Price lt 50&$count=true |
$expand | $expand=导航属性1,导航属性2 | 嵌套返回关联实体，减少请求往返 | Books?$expand=Author,Comments |
$search | $search='关键词' | 全文搜索（需服务端显式支持） | Books?$search='OData 实战' |
$format | $format=json/xml | 指定响应数据格式（默认 JSON） | Books?$format=xml |
$skiptoken | $skiptoken=服务端生成令牌 | 服务端分页游标，由响应中的@odata.nextLink提供 | Books?$skiptoken=eyJ0b2tlbiI6IjEwIn0= |
二、$filter 运算符大全
2.1 比较运算符
运算符 | 含义 | 示例 |
eq | 等于 | Price eq 59.9、Author eq '张三' |
ne | 不等于 | Publisher ne '机械工业出版社' |
gt | 大于 | Price gt 50 |
ge |