Cloud Query Language（简称 CQL） 是 AVOS Cloud 为查询 API 定制的一套类似 SQL 查询语法的子集和变种，主要目的是降低大家学习 AVOS Cloud 查询的 API 的成本，可以使用传统的 SQL 语法来查询 AVOS Cloud 应用内的数据。
本文档将详细介绍 CQL 的语法和常见用法。
最基本的一个查询某个 class 下的 100 条数据：
select * from GameScore
等价于（以 Android 为例子）:
AVQuery<AVObject> query = new AVQuery<AVObject>("GameScore");
List<AVObject> avObjects = query.find()
select一个完整的语法形式类似这样：
select [查询字段列表，逗号隔开] from [class 名称]
[where [条件列表]
[limit [skip],limit
[order by [排序字段列表] [asc |desc]]]]
一些小例子：
//查询结果只包含 name,score 以及内置字段(objectId,createdAt等)
select name,score from GameScore
//根据 name 查找
select * from GameScore where name='dennis'
//根据 name 和 score 同时查找
select * from GameScore where name is exists and score > 80 and score <= 100
//分页查找，从第 100 条开始向后查找 10 条数据
select * from GameScore limit 100,10
//根据 score 和 name 排序
select * from GameScore order by score,+name desc
where 之后的查询条件基本跟 SQL 语法相似，比如支持 or 和 and 的复合查询，支持=、!=、<、<等比较运算符，支持子查询、in 查询等。详细解释如下。
查询指定信息的对象，用= 比较符：
select * from GameScore where name='dennis'
查询不等于指定信息的对象：
select * from GameScore where name!='dennis'
也可以用<>运算符来表示不等于。
比较日期，使用 date 函数来转换，比如查询特定时间之前创建的对象：
select * from GameScore where createdAt < date('2011-08-20T02:06:57.931Z')
date 函数接收的日期格式必须是 2011-08-20T02:06:57.931Z 的 UTC 时间。更多内置函数请看最后的 内置函数 部分。
一些常见的查询运算符：
| Key | Operation |
|---|---|
| < | 小于 |
| <= | 小于等于 |
| > | 大于 |
| >= | 大于等于 |
| != 或者 <> | 不等于 |
| [not] like | 模糊查询 |
| [not] regexp | 正则匹配 |
| [not] in(子查询或者数组) | 包含或者不包含 |
| is [not] exists | 这个Key有值或者不存在值 |
比较运算符可以用在日期、字符串、数字甚至对象上。
模糊查询可以使用 like，比如查询名字以 dennis 开头的对象
select * from GameScore where name like 'dennis%'
% 表示模糊匹配的位置占位符。
like 本质上是转成 regexp 的正则匹配查询，因此上面的例子还可以写成：
select * from GameScore where name regexp 'dennis.*'
否定形式，查询名字不以 dennis 开头的对象：
select * from GameScore where name not like 'dennis%'
或者
select * from GameScore where name not regexp 'dennis.*'
正则匹配的效率一般，类似这种全文搜索请求，我们都推荐采用应用内全文搜索。
只返回 level 字段值存在的对象：
select * from GameScore where level is exists
反之，使用is not exists。
假设 scores 字段是一个数组，我们想查询分数里有 100 的成绩列表：
select * from GameScore where scores=100
如果想查找分数只有 两个 100 分的成绩：
select * from GameScore where scores all (100,100)
all 表示数组完全匹配。
使用 in 来做子查询，后面跟的可以是一个列表，例如查询名字是 dennis、catty 和 green 三个玩家的成绩：
select * from GameScore where name in ('dennis','catty','green')
当然，如果想查询的不在列表里，那可以使用not in:
select * from GameScore where name not in ('dennis','catty','green')
in 后面还可以是一个子查询，比如查询玩家信息，并且成绩大于 80 分的：
select * from Player where name in (select name from GameScore where score>80)
注意子查询必须指定查询的字段名称是select name
可以通过 CQL 进行地理位置信息查询，比如我想查询自己附近的玩家（从近到远排序），假设 location 字段是 GeoPoint 类型：
select * from Player where location near [30.0, -20.0]
其中 [30.0, -20.0] 是经纬度坐标。也可以使用 geopoint 函数来创建：
select * from Player where location near geopoint(30.0, -20.0)
只有在地理位置信息查询里才可以使用 [longitude, latitude] 这样的语法。在其他查询里将被作为数组类型。
为了限定搜索的最大距离，还可以使用 max distance来限定，比如限定在 1 公里内：
select * from Player where location near geopoint(30.0, -20.0) max 1 km
其他单位包括 miles 英里和radians 弧度，默认是弧度。
如果想查询某个矩形框内的对象，可以使用within [西南坐标] and [东北坐标]的语法：
select * from Player where location within [37.71,-122.53] and [30.82,-122.37]
使用 count 查询来返回符合查询条件的数目，比如查询整张表的记录数：
select count(*) from GameScore
count 不支持distinct等语法。仅限count(*)和count(objectId)
查询分数大于 60 并且小于等于 80 的成绩数目：
select count(*) from GameScore where score>60 and score<=80
查询个数的同时可以返回对象：
select count(*),* from GameScore
也可以返回特定的字段：
select count(*),name from GameScore
有几种方式来查询对象之间的关系数据, 如果您想获取对象，而这个对象的一个字段对应了另一个对象, 您可以用一个 where 查询, 自己构造一个 Pointer, 和其他数据类型一样。
举例说, 如果每一个 Comment 有一个 Post 对象在它的 post 字段上（Pointer 类型）, 您可以对一个 post 取得所有 comment:
select * from Comment where post=pointer('Post','51e3a359e4b015ead4d95ddc')
pointer 函数接收 className 和 objectId。
如果您想获取对象, 这个对象的一个字段指向的对象（必须是 Pointer）是符合另一个查询的, 您可以使用 in 查询。注意默认的 limit 是 100 而且最大的 limit 是 1000，这个限制同样适用于内部的查询, 所以对于较大的数据集您可能需要细心地构建查询来获得期望的行为. 举例说, 假设您有一个 Post 类和一个 Comment 类, 每个 Comment 都有一个指向它的 Post 的 Pointer, 您可以找到对于有图片的 Post 的 Comment:
select * from Comment where post in (select * from Post where image is exists)
如果 Post 下面有一个 key 是 Relation 类型，并且叫做 likes, 存储了喜欢这个 Post 的 User。您可以找到这些 user, 他们都 like 过同一个指定的 post:
select * from _User where related likes to pointer('Post', '51e3a359e4b015ead4d95ddc')
基本的查询形式是 releated <key> to <pointer>。
如果某个字段是 Pointer ，默认查询的时候，只会返回 {__type: 'Pointer', objectId: 'objectId', className:'Post'} 这些基本信息，如果希望同时将这个对象的其他信息查询下来，可以使用 include，比如查询 Comment 同时将 Post 带下来：
select include post, * from Comment
在 select 中采用 include <key> 就可以将某个 Pointer 字段关联查询出来。多个字段要多次 include:
select include post,include author from Comment
同样，还可以支持嵌套的 include 查询，比如 Post 里还有一个 Pointer 指向 Category:
select include post.category,* from Comment
你可以使用 and 和 or 来做符合查询，例如查询分数在 80 到 100 之间，可以用 and:
select * from GameScore where score>80 and score<=100
再加个条件，或者分数为0分的：
select * from GameScore where score>80 and score<=100 or score=0
and 的优先级高于 or，因此上面的查询也可以用括号来明确地表示这种优先级：
select * from GameScore where (score>80 and score<=100) or score=0
通过 limit 语句来限定返回结果大小，比如限定返回 100 个：
select * from Comment limit 100
可以设定从第 m+1 个元素开始，例如从第 101 个元素（包含）开始往后取 10 个：
select * from Comment limit 100,10
这个形式跟 MySQL 是类似的。
通过 order 语句来排序，order 语句只能出现在最后，不能在 where 和 limit 之前。
例如按照分数倒序排（分数高的前）：
select * from GameScore order by score desc
也可以写成：
select * from GameScore order by -score
加号表示升序，减号表示降序。
多个字段组合排序，例如分数高的前，名字相同的“更小”的在前（字母顺序）：
select * from GameScore order by -score,name
同样的语句可以写成：
select * from GameScore order by score,+name desc
或者
select * from GameScore order by -score,name asc
没有写上明确的加号或者减号的字段，将根据最后的 desc 或者 asc 来决定采用升序还是降序。
CQL 提供了一些内置函数来方便地创建 pointer、geopoint 等类型：
| Name | Operation |
|---|---|
| date('YYYY-MM-DDTHH:MM:SS.MMMMZ') | 创建日期类型 |
| pointer(className,objectId) | 创建 Pointer |
| geopoint(经度，维度) | 创建 GeoPoint |
| file(objectId) | 创建 file 类型 |
| base64(base64编码字符串) | 创建 Bytes 类型 |
| current_timestamp() | 创建当前日期 |
如果不使用这些函数，你也使用 REST API 文档 定义的 JSON 对象来创建特定类型，例如 Pointer:
select * from Comment where post=
{className:'Post', objectId:'51e3a334e4b0b3eb44adbe1a',__type:'Pointer'}
当然这样写就相对繁琐了。
CQL 最终还是转换成 REST API 里查询部分提到的各种 where 条件，因为多了一层转换，理论上会比直接使用 where 查询慢一点。并且 CQL 对长度有所限制，要求在 4096 字节以内。