云函数使用必读

权限

在云函数中执行的代码权限等级为超级管理员权限，不受数据表 ACL 的限制。因此开发者可以在云函数中执行一些特权操作，比如：

  • 批量修改用户信息
  • 写入一张所有人不可写的数据表
  • 删除数据表

云函数中 event 结构说明

一个典型的云函数代码结构如下：

  1. exports.main = function getArticles(event, callback) {
  2.   console.log(event)
  3.  callback(null, 'test')
  4. }

我们可以通过 event 对象，获取很多重要信息，说明如下：

参数类型描述示例
dataObject触发云函数的 data，若从 SDK 触发，则为 invokeFunction 中的 params, 若为触发器触发，则为触发触发器的数据行。{"id": "SnHzr40rtAufDke2r6FJ7xxE"}
eventTypeString触发云函数的类型SDK
jobIdString云函数任务的唯一标记 ID"a83ec181e20c4d50b83093157c8283a1"
requestObject如果云函数由小程序端触发，此处记录请求用户的信息见下面 request 示例

request 结构说明

参数类型描述
meta.ip_addressObject发起云函数请求的 IP
meta.user_agentString发起云函数请求设备的 userAgent
user.avatar_urlString发起云函数请求的用户头像
user.nicknameObject发起云函数请求的用户昵称
user.idObject发起云函数请求的用户 ID

request 示例如下

  1. {
  2.   "meta": {
  3.     "ip_address": "123.61.205.211",
  4.     "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.1.2 Safari/605.1.15"
  5.   },
  6.   "user": {
  7.     "avatar_url": "http://cdn.ifanr.cn/ifanr/default_avatar.png",
  8.     "id": 135570997,
  9.     "nickname": "ifanr"
  10.   }
  11. }

任务调度策略

当前版本的云函数并发限制为 10，即只能同时运行 10 个云函数任务，若在应用正在运行 10 个云函数任务时接收到新任务，将会按照以下策略进行调度：

  • 同步云函数任务：在 3 秒内会重试几次进行调度执行，如果每次调度时应用都已经有 10 个云函数任务在运行，则调度失败，云函数任务不会被运行。

  • 异步云函数任务：在 5 分钟内在重试几次进行调度执行，如果每次调度时应用都已经有 10 个云函数任务在运行，则调度失败，云函数任务不会被运行。