tencent cloud

云函数

动态与公告
产品动态
产品公告
新手指引
产品简介
产品概述
相关概念
工作原理
产品优势
应用场景
相关产品
购买指南
计费概述
计费方式
计费项与计费方式
函数算力支持
免费额度
产品定价
计费示例
欠费与停服说明
快速入门
使用控制台创建一个事件函数
操作指南
配额管理
函数管理
Web 函数管理
日志管理
并发管理
触发器管理
函数 URL
自定义域名
版本管理
别名管理
权限管理
运行实例管理
插件管理
监控与告警管理
网络配置
层管理
执行配置
扩展存储管理
DNS 缓存配置
资源托管模式管理
近离线资源托管模式
工作流
触发器
触发器概述
触发器事件消息结构汇总
API 网关触发器
COS 触发器
CLS 触发器
定时触发器
CKafka 触发器
Apache Kafka 触发器
MQTT 触发器
触发器配置描述
MPS 触发器
CLB 触发器说明
云 API 触发器
开发指南
基本概念
测试云函数
环境变量
依赖安装
使用容器镜像
使用 Docker 安装依赖
错误类型与重试策略
死信队列
云函数接入数据库
自动化部署
云函数状态码
常见错误码解决方法
开发者工具
Serverless Web IDE
函数间调用 SDK
第三方工具
代码开发
Python
Node.js
Golang
PHP
Java
Custom Runtime
使用镜像部署函数
Web 框架部署
通过命令行完成框架部署
快速部署 Egg 框架
快速部署 Express 框架
快速部署 Flask 框架
快速部署 Koa 框架
快速部署 Laravel 框架
快速部署 Nestjs 框架
快速部署 Nextjs 框架
快速部署 Nuxtjs 框架
快速部署 Django 框架
实践教程
最佳实践概述
云产品联合解决方案
业务开发相关实践
实时音视频 TRTC
对象存储 COS
消息队列 CKafka
日志服务CLS
负载均衡 CLB
视频处理 MPS
内容分发网络 CDN
云数据仓库 PostgreSQL
云点播 VOD
短信 SMS
Elasticsearch Service
定时任务
视频处理
客户案例
腾讯在线教育
在线教育行业案例
游戏聊天系统
腾讯互娱国际(IEGG)
API 文档
History
Introduction
API Category
Making API Requests
Other APIs
Namespace APIs
Layer Management APIs
Async Event Management APIs
Trigger APIs
Function APIs
函数和层的状态说明
Data Types
Error Codes
SDK文档
常见问题
通用问题
Web 函数相关问题
计费相关问题
网络相关问题
日志相关问题
SCF 工具相关问题
事件处理相关问题
API 网关触发器相关问题
相关协议
Service Level Agreement
联系我们
词汇表

MQTT 触发器

PDF
聚焦模式
字号
最后更新时间: 2025-08-21 18:11:26
您可以通过编写云函数来处理 MQTT 中收取到的消息。云函数后台模块可以作为消费者消费 MQTT 中的消息,并将消息传递给云函数。
MQTT 触发器具有以下特点:
Pull 模型:云函数的后台模块作为消费者,连接 MQTT 实例并消费消息。后台模块获取到消息后,会将消息封装到数据结构中并调用指定的函数,将消息数据传递给云函数。
同步调用:MQTT 触发器使用同步调用类型来调用函数。更多信息请参见 调用类型
注意:
当前消息队列 MQTT 版产品仅在部分地域开放,因此不同地域下的函数对 MQTT 触发器的开放程度存在差异,MQTT 已开放的地域均支持该功能。具体地域是否支持创建 MQTT 触发器以控制台实际展示为准。

MQTT 触发器属性

触发器名称:最大支持60个字符,支持 a-zA-Z0-9-_。必须以字母开头,且一个函数下不支持同名的多个 MQTT 触发器。
MQTT 实例:配置连接的 MQTT 实例,仅支持选择同地域下的实例。
Topic Filter:支持订阅自建 Topic 及 MQTT 消息队列内置系统 Topic。Topic Filter 表达式规则遵循 MQTT 协议的标准规则,可使用 “+”、“#” 通配符表达更多语义,详情请参见 MQTT V5.0 标准协议
消息属性过滤:通过自定义 WHERE 语句,表达更多、更灵活的消息属性过滤表达能力,所订阅Topic下,只有满足用户属性过滤声明的消息才会触发函数执行。
消费方式:顺序消费或非顺序消费,当前仅支持非顺序消费。
加密信息:需配置在 MQTT 实例 ACL 策略中具备访问权限的账号和密码。
开启 Base64 标准编码:会自动将您的消息内容进行 Base64 编码处理。
最大批量消息数:在拉取并批量投递给当前云函数时的最大消息数,默认为1,最高配置为10000。结合消息大小、写入速度等因素影响,每次触发云函数并投递的消息数量不一定能达到最大值,而是处在1 - 最大消息数之间的一个变动值。
重试次数:函数发生运行错误(含用户代码错误和 Runtime 错误)时的最大重试次数,默认为3。
最长等待时间:单次触发的最长等待时间。例如:用户配置了最大批量消息数为1000,最长等待时间为60秒。假设10秒后,云函数已经采集了1000条消息,则直接触发函数执行;假设过了60秒,云函数只采集到50条消息,也会触发函数执行。


MQTT 消费及消息传递

由于 MQTT 消息无主动推送能力,需要消费方通过拉取的方式,拉取到消息并进行消费。因此,在配置 MQTT 触发器后,云函数后台会通过启动 MQTT 消费模块,作为消费者,并在 MQTT 中创立消费客户端进行消费。
云函数后台的消费模块在消费到消息后,会根据一定的累积消息数量大小最大批量消息数等信息,组合为事件结构并发起函数调用(同步调用)。相关限制说明如下:
同步调用的事件大小限制:6MB,详情请参见 限制说明。如果 Topic 的消息很大,例如单条消息就已经达到6MB,那么由于同步调用的6MB限制,传递给云函数的事件结构中只会有一条消息,而不是用户配置的最大消息个数。
最大批量消息数:用户可配置,目前支持最高配置为10000。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈