jjzjj

通用查询语言(GQL)

xminn 2023-03-28 原文

使用本框架生成的接口默认支持通用查询语言,通用查询语言致力于统一不同模型,不同筛选条件,动态筛选,复合条件筛选的查询方式,无需改代码支持不同场景下的查询需求。

以下是一些通用查询语言示例:

  • 查询所有姓王的用户:
    GET /api/users?filters=name%5E%3D%E7%8E%8B
    其中filters的值是name^=王的urlencode编码

以下为了方便理解,只展示filters编码前的内容

  • 查询所有不姓王的用户:
    name^!=王

  • 查询所有姓王且年龄大于20岁的用户:
    name^=王&age>20

  • 查询所有王姓和李姓且年龄大于30岁的用户:
    (name^=王|name^=李)&age>30

  • 查询年龄正好是12,24,36岁的用户:
    age IN[12,24,36]

  • 查询20岁以上的用户,按年龄倒序排列:
    GET /api/users?sort=-age&filters=age>20

  • 查询20岁以上的用户,按年龄倒序排列, 每页5条,取第三页数据:
    GET /api/users?sort=-age&skip=20&take=5&filters=age>20

  • 查询20岁以上的用户,按年龄倒序排列, 每页5条,取第三页数据, 仅返回姓名和年龄两列数据:
    GET /api/users?sort=-age&skip=20&take=5&fields=name,age&filters=age>20

以下是GQL的详细说明

排序
sort: [[+-]FieldName,]
排序示例:
sort=+name,-date

分页

  • skip:跳过多少条记录
  • take:返回多少条记录

字段过滤

  • fields:逗号分隔的字段名列表,如果指定了该参数,则只返回指定的字段,用来加速网络传输。

字段过滤示例:
fields=name,age,date

筛选
筛选由逻辑运算和基础筛选单元构成,逻辑运算包括与,或,括号,基础筛选单元由字段名,比较符,值组成,若值中包含特殊字符,则需要urlencode。

筛选示例(未编码):
filters=name^=王&age>20&job IN[aaa,bbb,ccc]

以下是所有的比较符:
=, *=, ^=, $=, !=, *!=, ^!=, $!=, >, <, >=, <=, IS NULL, IS NOT NULL, IN[]

  • 各类型支持的比较符

    • 字符型(等于,包含,开始于,结束于,不等于,不包含,不开始于,不结束于,为空,不为空, IN Array[])
    • 数值型(等于,大于,小于,大于等于,小于等于,不等于,为空,不为空, IN Array[])
    • 日期型(等于,大于,小于,大于等于,小于等于,不等于,为空,不为空, IN Array[])
    • 布尔型(等于,不等于,为空,不为空, IN Array[])
    • 子表关联出的列表(包含,不包含)
  • 逻辑运算

    • 与:&
    • 或:|
    • 括号:()

逻辑运算支持嵌套, 与优先于或,所以连续用或必须用括号包起来

后续将介绍具体实现

有关通用查询语言(GQL)的更多相关文章

  1. ruby - ECONNRESET (Whois::ConnectionError) - 尝试在 Ruby 中查询 Whois 时出错 - 2

    我正在用Ruby编写一个简单的程序来检查域列表是否被占用。基本上它循环遍历列表,并使用以下函数进行检查。require'rubygems'require'whois'defcheck_domain(domain)c=Whois::Client.newc.query("google.com").available?end程序不断出错(即使我在google.com中进行硬编码),并打印以下消息。鉴于该程序非常简单,我已经没有什么想法了-有什么建议吗?/Library/Ruby/Gems/1.8/gems/whois-2.0.2/lib/whois/server/adapters/base.

  2. ruby - 如何将脚本文件的末尾读取为数据文件(Perl 或任何其他语言) - 2

    我正在寻找执行以下操作的正确语法(在Perl、Shell或Ruby中):#variabletoaccessthedatalinesappendedasafileEND_OF_SCRIPT_MARKERrawdatastartshereanditcontinues. 最佳答案 Perl用__DATA__做这个:#!/usr/bin/perlusestrict;usewarnings;while(){print;}__DATA__Texttoprintgoeshere 关于ruby-如何将脚

  3. ruby-on-rails - 在 Rails 和 ActiveRecord 中查询时忽略某些字段 - 2

    我知道我可以指定某些字段来使用pluck查询数据库。ids=Item.where('due_at但是我想知道,是否有一种方法可以指定我想避免从数据库查询的某些字段。某种反拔?posts=Post.where(published:true).do_not_lookup(:enormous_field) 最佳答案 Model#attribute_names应该返回列/属性数组。您可以排除其中一些并传递给pluck或select方法。像这样:posts=Post.where(published:true).select(Post.attr

  4. ruby - 寻找通过阅读代码确定编程语言的ruby gem? - 2

    几个月前,我读了一篇关于ruby​​gem的博客文章,它可以通过阅读代码本身来确定编程语言。对于我的生活,我不记得博客或gem的名称。谷歌搜索“ruby编程语言猜测”及其变体也无济于事。有人碰巧知道相关gem的名称吗? 最佳答案 是这个吗:http://github.com/chrislo/sourceclassifier/tree/master 关于ruby-寻找通过阅读代码确定编程语言的rubygem?,我们在StackOverflow上找到一个类似的问题:

  5. Unity 热更新技术 | (三) Lua语言基本介绍及下载安装 - 2

    ?博客主页:https://xiaoy.blog.csdn.net?本文由呆呆敲代码的小Y原创,首发于CSDN??学习专栏推荐:Unity系统学习专栏?游戏制作专栏推荐:游戏制作?Unity实战100例专栏推荐:Unity实战100例教程?欢迎点赞?收藏⭐留言?如有错误敬请指正!?未来很长,值得我们全力奔赴更美好的生活✨------------------❤️分割线❤️-------------------------

  6. 7个大一C语言必学的程序 / C语言经典代码大全 - 2

    嗨~大家好,这里是可莉!今天给大家带来的是7个C语言的经典基础代码~那一起往下看下去把【程序一】打印100到200之间的素数#includeintmain(){ inti; for(i=100;i 【程序二】输出乘法口诀表#includeintmain(){inti;for(i=1;i 【程序三】判断1000年---2000年之间的闰年#includeintmain(){intyear;for(year=1000;year 【程序四】给定两个整形变量的值,将两个值的内容进行交换。这里提供两种方法来进行交换,第一种为创建临时变量来进行交换,第二种是不创建临时变量而直接进行交换。1.创建临时变量来

  7. sql - 查询忽略时间戳日期的时间范围 - 2

    我正在尝试查询我的Rails数据库(Postgres)中的购买表,我想查询时间范围。例如,我想知道在所有日期的下午2点到3点之间进行了多少次购买。此表中有一个created_at列,但我不知道如何在不搜索特定日期的情况下完成此操作。我试过:Purchases.where("created_atBETWEEN?and?",Time.now-1.hour,Time.now)但这最终只会搜索今天与那些时间的日期。 最佳答案 您需要使用PostgreSQL'sdate_part/extractfunction从created_at中提取小时

  8. ruby-on-rails - solr 清理查询 - 2

    我在Rails上使用带有ruby​​的solr。一切正常,我只需要知道是否有任何现有代码来清理用户输入,比如以?开头的查询。或* 最佳答案 我不知道执行此操作的任何代码,但理论上可以通过查看parsingcodeinLucene来完成并搜索thrownewParseException(只有16个匹配!)。在实践中,我认为您最好只捕获代码中的任何solr异常并显示“无效查询”消息或类似信息。编辑:这里有几个“sanitizer”:http://pivotallabs.com/users/zach/blog/articles/937-s

  9. ruby-on-rails - Rails 3 在一个查询中包含多个表 - 2

    我正在为锦标赛开发一个Rails应用程序。我在这个查询中使用了三个模型:classPlayertruehas_and_belongs_to_many:tournamentsclassTournament:destroyclassPlayerMatch"Player",:foreign_key=>"player_one"belongs_to:player_two,:class_name=>"Player",:foreign_key=>"player_two"在tournaments_controller的显示操作中,我调用以下查询:Tournament.where(:id=>params

  10. ruby-on-rails - Sunspot:如何对具有不同值的多个字段进行全文查询? - 2

    我想用sunspot重现以下原始solr查询q=exact_term_text:fooORterm_textv:foo*ORalternate_text:bar*但我无法通过标准的太阳黑子界面理解这是否可能以及如何实现,因为看起来:fulltext方法似乎不接受多个文本/搜索字段参数我不知道将什么参数作为第一个参数传递给fulltext,就好像我通过了"foo"或"bar"结果不匹配如果我传递一个空参数,我得到一个q=*:*范围过滤器(例如with(:term).starting_with('foo*')(顾名思义)作为过滤器查询应用,因此不参与评分。似乎可以手动编写字符串(或者可能使

随机推荐