当数据表发生变更时,Tablestore Stream 实时捕获增量数据,Tablestore 触发器自动调用函数计算(FC)中的函数进行处理,无需轮询。
工作原理
Tablestore 触发器通过 Tablestore Stream 将数据表与函数计算连接。数据表发生行插入、更新或删除时,Stream 实时捕获变更,触发器检测到新记录后自动调用函数并传入事件数据。
这种事件驱动机制无需轮询,常见使用场景包括:
-
数据同步:将变更记录同步写入 OSS,构建持久化审计日志。
-
事件通知:用户资料更新时触发函数,向下游服务推送实时通知。
-
增量数据归档:每次写入时将变更记录归档到数据仓库。
除事件函数外,函数计算还支持 Web 函数、任务函数等类型。不同函数类型适用于不同的业务场景和技术架构需求,具体选择和对比可参见 技术选型指南 。
通过事件函数访问表格存储
以下步骤介绍如何开启 Tablestore Stream、创建事件函数并配置触发器。
前提条件:
-
已在支持地域创建 Tablestore 实例和数据表。
-
已登录函数计算控制台,并具备创建函数和触发器的权限。
步骤一:开启数据表 Stream 功能
Tablestore 触发器依赖 Stream 功能获取增量数据,创建触发器前需先为目标数据表开启 Stream。
目前支持创建 Tablestore 触发器的地域包括:华北 2(北京)、华东 1(杭州)、华东 2(上海)、华南 1(深圳)、日本(东京)、新加坡、德国(法兰克福)和中国香港。
-
登录表格存储控制台,在页面上方选择实例所在地域,然后单击目标实例别名。
-
在实例详情页面的数据表列表中单击目标数据表名称。
-
单击实时消费通道页签,然后单击Stream信息右侧的开启。
-
在开启Stream功能对话框中设置日志过期时长,然后单击开启。
日志过期时长取值为非零整数,单位为小时,最长为 168 小时。日志过期时长设置后不能修改,请谨慎设置。
步骤二:创建和配置事件函数
Tablestore 触发器只能引用与函数处于同一地域的 Tablestore 实例和数据表,请确认两者地域一致。
-
登录函数计算控制台,在页面上方选择与 Tablestore 实例相同的地域。
-
在左侧菜单栏单击。
-
单击创建函数,选择函数类型为事件函数,然后单击创建事件函数。
-
按以下说明配置函数参数,完整参数说明请参见创建事件函数。
-
函数名称:函数名称在同一账号及地域下必须唯一,且符合命名规范。
-
运行环境:选择内置运行时,然后选择熟悉的语言和版本(如 Python、Java 等),此处以Python 3.12为例。
-
代码上传方式:选择代码上传方式,此处以通过 ZIP 包上传代码为例,可下载并上传示例代码tablestore_trigger_example.zip。
-
-
单击创建,完成函数创建。
步骤三:测试和验证事件函数
配置 Tablestore 触发器前,先通过模拟事件测试函数。Tablestore 触发器运行时使用 CBOR(简明二进制对象表示)格式编码,控制台支持以JSON格式进行模拟测试。
-
在函数详情页单击测试函数旁的下拉箭头,然后单击配置测试参数。
-
填写事件名称(如
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 } ] } ] } -
单击测试函数,等待函数测试完成。函数执行成功时返回结果为
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 触发器,实现数据表变更时自动调用函数。
-
在函数详情页单击触发器页签,然后单击创建触发器。
-
按以下说明配置触发器参数。
-
触发器类型:选择表格存储 Tablestore。
-
名称:自定义填写触发器名称,如
test_trigger。 -
实例:选择目标 Tablestore 实例。
-
表格:选择目标数据表。
-
-
单击确定,完成触发器创建。
-
在 Tablestore 数据表中插入或更新一行数据,此处以在表格存储控制台插入一行数据为例。
-
在函数详情页单击日志页签,查看函数调用日志和调用结果。单击操作列的请求日志可查看详细日志信息。
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。 -
查看函数运行日志,确认是否因函数执行失败导致持续重试直到日志数据过期。
-