文档中心

快速入门

安装

基本操作

数据模型

SQL引擎

系统架构

数据库管理

连接器

驱动

参考手册

故障排除

SAC

版本信息

REST接口

创建集合空间

说明 例子
请求头 同通用请求头
请求内容 cmd: create collectionspace
name: 集合空间名字
cmd=create collectionspace&name=foo
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": -33, "description": "Collection space already exists" }
说明

删除集合空间

说明 例子
请求头 同通用请求头
请求内容 cmd: drop collectionspace
name: 集合空间名字
cmd=drop collectionspace&name=foo
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

创建集合

说明 例子
请求头 同通用请求头
请求内容 cmd: create collection
name: 集合的全称(集合空间.集合)
options: 选项(可选参数,可不填)
cmd=create collection&name=foo.bar
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

删除集合

说明 例子
请求头 同通用请求头
请求内容 cmd: drop collection
name: 集合的全称(集合空间.集合)
cmd=drop collection&name=foo.bar
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

插入数据

说明 例子
请求头 同通用请求头
请求内容 cmd: insert
name: 集合的全称(集合空间.集合)
insertor: 待插入的数据
cmd=insert&name=foo.bar&insertor={"age":12,"name":"hello"}
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

查询数据

说明 例子
请求头 同通用请求头
请求内容 cmd: query
name: 集合的全称(集合空间.集合)
sort: 待排序字段名(可选参数,可不填)
selector: 查询结果列(可选参数,可不填)
skip: 跳过多少行(可选参数,可不填)
returnnum: 最大返回条数(可选参数,可不填)
filter: 查询条件(可选参数,可不填)
cmd=query&name=foo.bar&sort={"name":1}&skip=0&returnnum=1&filter={"name":"hello"}
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{
返回表里的记录
}
...
{ "errno": 0 }{ "_id":{ "$oid":"54def72f0d8737161d9d6934" },"age":12,"name":"hello" }
说明

查询更新数据

说明 例子
请求头 同通用请求头
请求内容 cmd: queryandupdate
name: 集合的全称(集合空间.集合)
updator: 更新操作
sort: 待排序字段名(可选参数,可不填)
selector: 查询结果列(可选参数,可不填)
skip: 跳过多少行(可选参数,可不填)
returnnum: 最大返回条数(可选参数,可不填)
filter: 查询条件(可选参数,可不填)
returnnew: 是否返回更新后记录(可选参数,可不填)
cmd=queryandupdate&name=foo.bar&updator={$set:{"age":100}}&filter={"name":"hello"}&returnnew=true
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{
返回表里的记录
}
...
{ "errno": 0 }{ "_id":{ "$oid":"54def72f0d8737161d9d6934" },"age":100,"name":"hello" }
说明

查询删除数据

说明 例子
请求头 同通用请求头
请求内容 cmd: queryandremove
name: 集合的全称(集合空间.集合)
sort: 待排序字段名(可选参数,可不填)
selector: 查询结果列(可选参数,可不填)
skip: 跳过多少行(可选参数,可不填)
returnnum: 最大返回条数(可选参数,可不填)
filter: 查询条件(可选参数,可不填)
cmd=queryandremove&name=foo.bar&filter={"name":"hello"}
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{
返回表里的记录
}
...
{ "errno": 0 }{ "_id":{ "$oid":"54def72f0d8737161d9d6934" },"age":12,"name":"hello" }
说明

删除记录

说明 例子
请求头 同通用请求头
请求内容 cmd: delete
name: 集合的全称(集合空间.集合)
deletor: 删除条件
cmd=delete&name=foo.bar&deletor={"name":"hello"}
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

更新记录

说明 例子
请求头 同通用请求头
请求内容 cmd: update
name: 集合的全称(集合空间.集合)
updator: 更新操作
filter: 更新条件
cmd=update&name=foo.bar&updator={$set:{"age":100}}&filter={"name":"hello"}
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

更新或插入记录

说明 例子
请求头 同通用请求头
请求内容 cmd: upsert
name: 集合的全称(集合空间.集合)
updator: 更新操作
filter: 更新条件(可选参数,可不填)
setoninsert: 插入数据(可选参数,可不填)
cmd=upsert&name=foo.bar&updator={$set:{"age":100}}&filter={"name":"hello"}&setoninsert={"sex":"male"}
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

获取记录数

说明 例子
请求头 同通用请求头
请求内容 cmd: get count
name: 集合的全称(集合空间.集合)
filter: 过滤条件(可选)
cmd=get count&name=foo.bar
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{
Total: 总计数
}
{ "errno": 0 }{ "Total":1 }
说明

修改表属性

说明 例子
请求头 同通用请求头
请求内容 cmd: alter collection
name: 集合的全称(集合空间.集合)
options: 属性
cmd=alter collection&name=foo.bar&options={ShardingKey:{age:1},ShardingType:"hash"}
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

表分区

说明 例子
请求头 同通用请求头
请求内容 cmd: split
name: 集合的全称(集合空间.集合)
source: 源数据组
target: 目标数据组
splitpercent: 百分比
splitquery: 开始条件
splitendquery: 结束条件
cmd=split&name=foo.bar&source=group1&target=group2&splitpercent=50
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{ "errno": 0 }
说明

列出数据组

说明 例子
请求头 同通用请求头
请求内容 cmd: list groups cmd=list groups
说明
响应头 同通用响应头
响应内容 {
errno: 返回值,0表示成功,其他为失败
description: 失败时的错误描述
}
{
返回数据组的内容
}
{ "errno": 0 }
说明
回到顶部