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: 是否返回更新后记录（可选参数，可不填）
flag: 标志位（可选参数，可不填）		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” }]
说明

Note:

flag既支持字符串形式，也支持数值型。数值型包括十六进制（0x开头）、八进制（0开头）、十进制。
取值如下：
SDB_QUERY_FORCE_HINT(0x00000080)
SDB_QUERY_PARALLED(0x00000100)
SDB_QUERY_WITH_RETURNDATA(0x00000200)
SDB_QUERY_KEEP_SHARDINGKEY_IN_UPDATE(0x00008000)
多个flag用“|”分隔，如flag=SDB_QUERY_FORCE_HINT|SDB_QUERY_PARALLED。

查询删除数据

说明例子
请求头同通用请求头
请求内容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: 更新条件
flag: 标志位（可选参数，可不填）		cmd=update&name=foo.bar&updator={$set:{“age”:100}}&filter={“name”:”hello”}&flag=SDB_UPDATE_KEEP_SHARDINGKEY
说明
响应头同通用响应头
响应内容{
errno: 返回值，0表示成功，其他为失败
description: 失败时的错误描述
}		[{ “errno”: 0 }]
说明

Note:
flag既支持字符串形式，也支持数值型。数值型包括十六进制（0x开头）、八进制（0开头）、十进制。
取值如下：
SDB_UPDATE_KEEP_SHARDINGKEY(0x00008000)

更新或插入记录

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

Note:
flag既支持字符串形式，也支持数值型。数值型包括十六进制（0x开头）、八进制（0开头）、十进制。
取值如下：
SDB_UPDATE_KEEP_SHARDINGKEY(0x00008000)

获取记录数

说明例子
请求头同通用请求头
请求内容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 groupscmd=list groups
说明
响应头同通用响应头
响应内容{
errno: 返回值，0表示成功，其他为失败
description: 失败时的错误描述
}
{
返回数据组的内容
}		[{ “errno”: 0 }]
说明

收集统计信息

说明例子
请求头同通用请求头
请求内容cmd: analyze
options: 设定分析模式、指定集合空间以及命令位置参数		cmd=analyze
cmd=analyze&options={Collection:”foo.bar”}
说明请参考 db.analyze()
响应头同通用响应头
响应内容{
errno: 返回值，0表示成功，其他为失败
description: 失败时的错误描述
}		[{ “errno”: 0 }]
说明

查询快照

说明例子
请求头同通用请求头
请求内容cmd: snapshot [type]
sort: 待排序字段名（可选参数，可不填）
selector: 查询结果列（可选参数，可不填）
filter: 查询条件（可选参数，可不填）
hint: 快照参数，格式: { $options: {<options>} }（可选参数，可不填）
skip: 跳过多少行（可选参数，可不填）
returnnum: 最大返回条数（可选参数，可不填）		cmd=snapshot health&filter={“IsPrimary”:false}&selector={“NodeName”:null}&sort={“NodeName”:-1}
说明请参考 db.snapshot()
响应头同通用响应头
响应内容{
errno: 返回值，0表示成功，其他为失败
description: 失败时的错误描述
}
{
返回快照
}
…		[{ “errno”: 0 },{ “NodeName”: “ubuntu-test-03:41000” },{ “NodeName”: “ubuntu-test-03:40000” }]
说明

Note:
[type]指快照类型，分别有：
contexts
contexts current
sessions
sessions current
collections
collectionspaces
database
system
catalog
accessplans
health
configs

更新配置参数

说明例子
请求头同通用请求头
请求内容cmd: update config
configs: 配置参数，包含配置名和配置值
options: 命令位置参数		cmd=update config
cmd=update config&configs={‘diagnum’:27}&options={‘svcname’:’20000’}
说明请参考 db.updateConf()
响应头同通用响应头
响应内容{
errno: 返回值，0表示成功，其他为失败
description: 失败时的错误描述
}		[{ “errno”: 0 }]
说明

删除配置参数

说明例子
请求头同通用请求头
请求内容cmd: delete config
configs: 配置参数，包含配置名和配置值
options: 命令位置参数		cmd=update config
cmd=update config&configs={‘diagnum’:1}&options={‘svcname’:’20000’}
说明请参考 db.deleteConf()
响应头同通用响应头
响应内容{
errno: 返回值，0表示成功，其他为失败
description: 失败时的错误描述
}		[{ “errno”: 0 }]
说明