适用版本: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]对结果排序,默认升序ascBooks?$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 50ge
OData V4.01 完整查询语法速查表
发布时间:2026/6/3 15:36:30
适用版本: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]对结果排序,默认升序ascBooks?$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 50ge