抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 快速入门
  • 开发指南
  • 功能服务
  • 行业解决方案
  • 迁移指南
  • API 参考
  • 云函数
  • 云托管
  • 触发器接口开发文档
  • 云数据库
  • 客户端
  • 服务端
  • 如何使用云数据库SDK
  • SDK概览
  • Database
  • Collection
  • Document
  • Command
  • Aggregate Command
  • 对象存储
  • 媒资管理OpenApi
  • 配置中心SDK
  • 公共错误码
  • 最佳实践
  • 产品计费
  • 常见问题
  • 产品动态
  • Database

    数据库实例

    collection

    支持端:Node SDK
    获取集合的引用。方法接受一个 name 参数,指定需引用的集合名称。

    参数说明

    name:string
    集合名称

    示例语法:Node SDK

    import { dySDK } from '@open-dy/node-server-sdk'; const db = dySDK.database(); const todosCollection = db.collection('todos');

    错误说明

    错误语法1

    const db = cloud.database(); const todosCollection = db.collection('');

    错误信息

    { errorCode: 156401, errMsg: '集合名必填', }

    serverDate

    支持端:Node SDK
    构造一个服务端时间引用,可用于查询条件,更新字段值或者新增记录。

    参数说明

    offset
    参数
    类型
    默认值
    必填
    说明
    最低支持版本
    offset
    number
    -
    否
    引用的服务端时间偏移量,毫秒为单位,可以是正数或负数
    ​

    示例语法

    默认采用服务端时间。
    db.collection('todos').add({ name: 'xiaoming', createTime: db.serverDate()}) };
    更新字段为服务端时间往后1分钟。
    db.collection('todos').add({ name: 'xiaoming', createTime: db.serverDate({ offset: 60 * 1000 )}) }

    错误说明

    offset 传递了非整型。

    错误语法1

    db.collection('todos').add({ name: 'xiaoming', createTime: db.serverDate({ offset: '' as any )}) };

    错误信息

    { errMsg: 'serverDate值必须是一个整型', errorCode: 156401 }

    Regexp

    构造正则表达式,仅需在普通 js 正则表达式无法满足的情况下使用

    options 参数说明

    options 支持 i, m, s 这三个 flag,注意 JavaScript 原生正则对象构造时仅支持其中的 i, m 两个 flag,因此需要使用到 s 这个 flag 时必须使用 db.RegExp 构造器构造正则对象。flag 的含义见下表:
    flag
    说明
    i
    大小写不敏感
    m
    跨行匹配;让开始匹配符 ^ 或结束匹配符 $ 时除了匹配字符串的开头和结尾外,还匹配行的开头和结尾
    s
    让 . 可以匹配包括换行符在内的所有字符

    基础用法示例

    // 原生 JavaScript 对象 const res = await db .collection('regdb') .where({ name: /ckq/i, }) .get(); // 数据库正则对象 const res = await db .collection('regdb') .where({ name: db.RegExp({ regexp: 'ckq', options: 'i', }), }) .get(); // 用 new 构造也是可以的 const res = await db .collection('regdb') .where({ name: new db.RegExp({ regexp: 'ckq', options: 'i', }), }) .get();

    错误说明

    错误语法1:

    await db .collection('dbcommand_error_todos') .where({ name: db.RegExp({}) }) .get();

    错误信息

    // 错误信息 { "errorCode": 156401, "errMsg": "regexp 值必须有匹配项" }

    错误语法2:

    await db .collection('dbcommand_error_todos') .where({ name: db.RegExp() }) .get();

    错误信息

    // 错误信息 { "errorCode": 156401, "errMsg": "regexp 值必须是个对象" }