使用函数计算

更新时间:
复制 MD 格式

当数据表发生变更时,Tablestore Stream 实时捕获增量数据,Tablestore 触发器自动调用函数计算(FC)中的函数进行处理,无需轮询。

工作原理

Tablestore 触发器通过 Tablestore Stream 将数据表与函数计算连接。数据表发生行插入、更新或删除时,Stream 实时捕获变更,触发器检测到新记录后自动调用函数并传入事件数据。

image

这种事件驱动机制无需轮询,常见使用场景包括:

  • 数据同步:将变更记录同步写入 OSS,构建持久化审计日志。

  • 事件通知:用户资料更新时触发函数,向下游服务推送实时通知。

  • 增量数据归档:每次写入时将变更记录归档到数据仓库。

    除事件函数外,函数计算还支持 Web 函数、任务函数等类型。不同函数类型适用于不同的业务场景和技术架构需求,具体选择和对比可参见 技术选型指南 。

通过事件函数访问表格存储

以下步骤介绍如何开启 Tablestore Stream、创建事件函数并配置触发器。

前提条件:

  • 已在支持地域创建 Tablestore 实例和数据表。

  • 已登录函数计算控制台,并具备创建函数和触发器的权限。

    步骤一:开启数据表 Stream 功能

    Tablestore 触发器依赖 Stream 功能获取增量数据,创建触发器前需先为目标数据表开启 Stream。

    目前支持创建 Tablestore 触发器的地域包括:华北 2(北京)、华东 1(杭州)、华东 2(上海)、华南 1(深圳)、日本(东京)、新加坡、德国(法兰克福)和中国香港。
    1. 登录表格存储控制台,在页面上方选择实例所在地域,然后单击目标实例别名。

    2. 在实例详情页面的数据表列表中单击目标数据表名称。

    3. 单击实时消费通道页签,然后单击Stream信息右侧的开启。

    4. 在开启Stream功能对话框中设置日志过期时长,然后单击开启。

      日志过期时长取值为非零整数,单位为小时,最长为 168 小时。日志过期时长设置后不能修改,请谨慎设置。

    步骤二:创建和配置事件函数

    Tablestore 触发器只能引用与函数处于同一地域的 Tablestore 实例和数据表,请确认两者地域一致。

    1. 登录函数计算控制台,在页面上方选择与 Tablestore 实例相同的地域。

    2. 在左侧菜单栏单击函数管理 > 函数列表。

    3. 单击创建函数,选择函数类型为事件函数,然后单击创建事件函数。

    4. 按以下说明配置函数参数,完整参数说明请参见创建事件函数。

      • 函数名称:函数名称在同一账号及地域下必须唯一,且符合命名规范。

      • 运行环境:选择内置运行时,然后选择熟悉的语言和版本(如 Python、Java 等),此处以Python 3.12为例。

      • 代码上传方式:选择代码上传方式,此处以通过 ZIP 包上传代码为例,可下载并上传示例代码tablestore_trigger_example.zip。

    5. 单击创建,完成函数创建。

    步骤三:测试和验证事件函数

    配置 Tablestore 触发器前,先通过模拟事件测试函数。Tablestore 触发器运行时使用 CBOR(简明二进制对象表示)格式编码,控制台支持以JSON格式进行模拟测试。

    1. 在函数详情页单击测试函数旁的下拉箭头,然后单击配置测试参数。

    2. 填写事件名称(如test-event),在文本编辑框中输入以下示例事件,然后单击确定。

      {
          "Version": "Sync-v1",
          "Records": [
              {
                  "Type": "PutRow",
                  "Info": {
                      "Timestamp": 1506416585740836
                  },
                  "PrimaryKey": [
                      {
                          "ColumnName": "pk_0",
                          "Value": 1506416585881590900
                      },
                      {
                          "ColumnName": "pk_1",
                          "Value": "2017-09-26 17:03:05.8815909 +0800 CST"
                      },
                      {
                          "ColumnName": "pk_2",
                          "Value": 1506416585741000
                      }
                  ],
                  "Columns": [
                      {
                          "Type": "Put",
                          "ColumnName": "attr_0",
                          "Value": "hello_table_store",
                          "Timestamp": 1506416585741
                      },
                      {
                          "Type": "Put",
                          "ColumnName": "attr_1",
                          "Value": 1506416585881590900,
                          "Timestamp": 1506416585741
                      }
                  ]
              }
          ]
      }
    3. 单击测试函数,等待函数测试完成。函数执行成功时返回结果为OK,单击日志输出可查看执行日志。

      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Begin to handle event
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] --------------------------------------------------
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Event Type: PutRow
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Timestamp: 1506416585740836
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Primary Keys:
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Name: pk_0, Value: 1506416585881590900
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Name: pk_1, Value: 2017-09-26 17:03:05.8815909 +0800 CST
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Name: pk_2, Value: 1506416585741000
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] Attribute Columns:
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Type: Put, Name: attr_0, Value: hello_table_store, Timestamp: 1506416585741
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO]   Type: Put, Name: attr_1, Value: 1506416585881590900, Timestamp: 1506416585741
      2025-11-24 16:02:59 1-69241131-15e0c7d6-8ec1eb81c700 [INFO] --------------------------------------------------

    步骤四:配置和验证触发器

    函数测试通过后,配置 Tablestore 触发器,实现数据表变更时自动调用函数。

    1. 在函数详情页单击触发器页签,然后单击创建触发器。

    2. 按以下说明配置触发器参数。

      • 触发器类型:选择表格存储 Tablestore。

      • 名称:自定义填写触发器名称,如test_trigger。

      • 实例:选择目标 Tablestore 实例。

      • 表格:选择目标数据表。

    3. 单击确定,完成触发器创建。

    4. 在 Tablestore 数据表中插入或更新一行数据,此处以在表格存储控制台插入一行数据为例。

    5. 在函数详情页单击日志页签,查看函数调用日志和调用结果。单击操作列的请求日志可查看详细日志信息。

      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Begin to handle event
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] --------------------------------------------------
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Event Type: PutRow
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Timestamp: 1763973009228992
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Primary Keys:
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO]   Name: id, Value: 8
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO]   Name: name, Value: test-name
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] Attribute Columns:
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO]   Type: Put, Name: age, Value: 18, Timestamp: 1763973009229
      2025-11-24 16:30:12 1-69241793-15071122-c8e16b8b5ce5 [INFO] --------------------------------------------------

配额与限制

  • 避免循环调用。 函数代码不能向触发该函数的数据表写入数据,否则会造成函数无限调用。

  • 执行失败会触发重试。 函数执行失败后,函数计算会持续重试,直到 Tablestore Stream 中的日志数据过期。

    说明
    • 函数执行失败分以下两种情况,计费方式不同:

      • 函数代码运行异常:函数实例已启动,因此会产生执行费用。

      • 函数实例启动失败:因启动指令错误等原因导致实例未成功拉起,不产生费用。

      • 删除触发器不会立即停止运行中的实例:已启动的函数实例会继续运行直到完成或超时。

    • 如需中止无限重试,可关闭该数据表的 Stream 功能。关闭前请确认没有其他触发器依赖此数据表,以免影响其他触发器正常运行。

常见问题

  • 为什么无法在某地域创建 Tablestore 触发器? 请确认该地域在支持列表中。Tablestore 触发器当前仅支持部分地域,详见步骤一。

  • 创建触发器时找不到已创建的数据表? 函数计算函数与 Tablestore 数据表必须处于同一地域。请在函数计算控制台确认已选择正确的地域。

  • 使用 Tablestore 触发器时持续报客户端取消的错误? 一般是客户端超时时间小于函数执行时间所致。调大客户端超时时间即可解决,具体操作请参见客户端断开连接,报错Invocation canceled by client怎么办?。

  • 数据表有新增数据但触发器未触发? 按以下顺序排查:

    • 确认数据表已开启 Stream 功能。

    • 确认创建触发器时配置的角色权限正确,可使用默认触发器角色AliyunTableStoreStreamNotificationRole。

    • 查看函数运行日志,确认是否因函数执行失败导致持续重试直到日志数据过期。