# 云函数查询一条数据库数据

# 简要描述

云函数查询数据库数据；若有多条匹配，只返回一条
参数结构与查询一条数据库数据完全一致：按「字段名 → 字段值」平铺作为等值条件

# 方法名称

potato.selectOne(tableName, param)

# 参数说明

参数	必选	类型	说明
tableName	是	String	表名称
param	是	Object	查询条件；键为字段名，值为条件值（等值匹配）

参数名（动态）	必选	类型	说明
{columnName}	否	string	字段名称，如 `id`
{value}	否	object	对应字段值，如 `1`

# 调用实例

// 查询 id 为 1 的一条数据（与 HTTP 接口 body 一致）
var param = {
    id: '1'
};
var res = potato.selectOne('test', param);
return res;

1
2
3
4
5
6

# 多字段等值条件

var param = {
    id: '1',
    name: '土豆'
};
var res = potato.selectOne('test', param);
return res;

1
2
3
4
5
6

需要大于、小于、like 等表达式时，请使用 potato.selectList 的 where + reg，不要用 selectOne。

# 返回示例（方法直接返回）

{
    "name": "1",
    "id": 1
}

1
2
3
4

# 客户端调用云函数

请求 POST /api/execFunction，验签见接口规范。

# 请求头

参数名	必选	类型	说明
Content-Type	是	string	JSON 时传 `application/json`
askKey	是	string	验证 app 的令牌
sign	否	string	开启验签时必传
time	否	string	开启验签时必传（毫秒时间戳）
apiUserToken	否	string	用户令牌
nonce	否	string	开启 V3 验签必传，6分钟内不可重复

# 请求体

参数	必选	类型	说明
name	是	String	云函数名称
params	否	Object	自定义参数

# 返回示例

{
    "code": "200",
    "message": "",
    "status": true,
    "data": {
        "name": "1",
        "id": 1
    },
    "pc": null,
    "time": null,
    "nonce": null,
    "sign": null,
    "reqSign": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 返回参数说明

参数名	类型	说明
code	string	200 成功；203 无数据；403 权限异常或登录超时；500 请求异常
status	boolean/int	业务状态
data	object	单条记录
nonce	string	V3 验签时返回
sign	string	开启验签时返回
reqSign	string	请求签名
time	long/string	开启验签时返回

# 备注

使用此方法需要开通会员并配置数据源
参数约定以数据库接口为准：查询一条数据库数据
验签算法以接口规范为准（V1 / V2 / V3）
更多错误代码请查看错误代码参考

← HTTP POST请求查询多条数据库数据 →