Skip to main content

使用限制

概述​

为了避免生产环境中因行为定义不明确而导致各种边缘状况，AutoMQ Cloud 对产品范围内的参数、配额和行为等做出约束和规范。用户在使用过程中需要注意不要打破约束，如有约束不满足实际使用场景，请及时提工单寻求帮助，参考获取人工服务▸ 。

参数类限制​

以下参数中各资源的命名及备注类限制值不支持调整，请严格按照规范设置，避免因出现特殊字符或长度超限导致系统处理异常。

公共参数限制​

参数项
限制值
说明

实例名称


  • 字符限制：仅支持中文、字母 a～z 或 A～Z、数字 0～9 和下划线（_）和中划线（-）。
  • 长度限制：3～64 个字符。

名称和备注应该尽量使用简洁、常用的短语和简写标识，避免使用特殊字符造成显示的异常。


实例备注


  • 字符限制：仅支持中文、字母 a～z 或 A～Z、数字 0～9 和下划线（_）和中划线（-）。
  • 长度限制：0～128 个字符。

环境成员名


  • 字符限制：仅支持字母 a～z 或 A～Z、数字 0～9 和下划线（_）和中划线（-）。
  • 长度限制：3～64 个字符。

环境成员密码


  • 字符限制：仅支持可见字符。
  • 长度限制：8～16 个字符。

集成名称


  • 字符限制：仅支持中文、字母 a～z 或 A～Z、数字 0～9 和下划线（_）和中划线（-）。
  • 长度限制：3～64 个字符。

迁移名称


  • 字符限制：仅支持中文、字母 a～z 或 A～Z、数字 0～9 和下划线（_）和中划线（-）。
  • 长度限制：3～64 个字符。

实例级配置​

参数项
限制值
说明
log.retention.ms

消息保存时长


  • 默认值：7 天
  • 限制范围：1 小时 ~ 60 天
  • 可以自定义修改

消息保存时长背后影响了存储空间的消耗和成本，建议业务合理评估。如有不满足，请 获取人工服务▸ 寻求帮助。


message.max.bytes

消息大小上限


  • 默认值：20 MiB
  • 限制值： 0 B ~ 50 MiB
  • 支持自定义修改

如果当前参数限制不满足需求，请 获取人工服务▸ 寻求帮助。


offsets.retention.minutes

消费进度保存时长


  • 限制值： 7 天
  • 不支持自定义修改
fetch.max.bytes

单次拉取数据上限


  • 限制值： 55 MB
  • 不支持自定义修改

单分区写入吞吐上限


  • 限制值： 4 MBps
  • 不支持自定义修改

单分区读写吞吐存在限制，建议应用使用不同的消息 key 将读写压力分摊到不同的分区上，避免分区热点。请 获取人工服务▸ 寻求帮助。


单分区读取吞吐上限


  • 限制值： 4 MBps
  • 不支持自定义修改
auto.create.topics.enable

自动创建 Topic 开关


  • 默认值：true
  • 限制范围：true/false
  • 可以自定义修改

自动创建 Topic 开关建议关闭，通过管控系统和 Admin API 管理所有的 topic，避免topic 无法管理。


num.partitions

默认创建 Topic 分区数


  • 默认值：1
  • 限制范围：1~1024
  • 可以自定义修改

默认创建 Topic 分区数在使用自动创建 Topic 时使用，建议在集群粒度合理设置，避免自动创建 Topic 消耗过多的分区数额度。


Topic 级配置​

参数项
限制值
说明
compression.type
  • 默认值：producer
  • 限制值：
    • Zstd
    • lz4
    • Producer
    • Uncompressed
    • Snappy
    • gzip
      • 支持自定义修改

设置 Topic 的最终压缩类型。该配置支持('gzip'， 'snappy'， 'lz4'， 'zstd')；除上述配置选项还支持 'uncompressed'，相当于没有压缩；'producer'配置值指的是保留生产者配置的压缩类型。


cleanup.policy

消息清理策略


  • 默认值：delete
  • 限制范围：
    • delete：按照保留的时间定期清理最早的消息。
    • compact：按照消息的 key 定期合并消息，只保留最新版本。
      • 可以自定义修改

大部分业务场景推荐使用 delete 类型，仅在保留状态数据的场景使用 compact 类型。


retention.ms
  • 默认值：跟随集群当前配置
  • 限制值： 1 小时 ~ 60 天
  • 支持自定义修改

设置 topic 自定义消息保存时长，仅针对清理策略为 delete 类型的 topic 有效，该配置会覆盖集群默认的配置。


max.message.bytes
  • 默认值：跟随集群当前配置
  • 限制值： 0 B ~ 50 MiB
  • 支持自定义修改

设置当前 Topic 允许的record batch 大小上限，发送超过该限制的消息将被拒绝。


message.timestamp.type
  • 默认值：CreateTime
  • 限制值：
    • LogAppendTime
    • CreateTime
      • 可以自定义修改

定义消息中的时间戳是消息创建时间还是日志追加时间。该值应该是' create time '或' log append time '。


retention.bytes
  • 默认值：-1
  • 支持自定义修改

针对 delete 类型清理策略的 topic 生效，控制每个分区数据保留的空间上限。默认情况下，没有大小限制，只有时间限制。此限制是在分区级别，因此将其乘以分区数量以计算 topic 级别的保留空间。该配置会覆盖集群默认配置。


delete.retention.ms
  • 默认值：1 天
  • 限制值： 0 小时 ~ 60 天
  • 支持自定义修改

设置 为 Compact 类型 Topic 保留删除墓碑标记的时间，仅针对 Compact 类型 Topic 生效。该配置约定了消费者必须在此时间内读取消息才有可能获取最后的有效快照，否则消费者将可能读取到不完整的数据。


Topic 命名


  • 字符限制：仅支持字母az或AZ、数字0~9、下划线（_）中划线（-）和点（.）。
  • 长度限制：1~250个字符。
  • 其他限制：不允许下划线（_）开头。

无。


Topic 备注


  • 字符限制：仅支持中文、字母az或AZ、数字0~9和下划线（_）。
  • 长度限制：1~256个字符。

automq.table.topic.enable


  • 默认值：false
  • 限制值：布尔值
  • 支持自定义修改

设置是否启用 AutoMQ Table Topic。启用后，将创建 Iceberg Table，用于存储 AutoMQ Table 数据。


automq.table.topic.commit.interval.ms


  • 默认值：5min
  • 限制值：10s 15min
  • 支持自定义修改

设置 AutoMQ Table Topic 的数据提交间隔时间。提交间隔越短，数据实时性越高，相应的处理成本也会增加，反之亦然。


automq.table.topic.namespace


  • 默认值：无
  • 限制值：该值需确保符合当前集群使用的Catalog对 namespace/database 的命名要求
  • 不支持修改

Table Topic 在 Catalog 下的 Namespace。


automq.table.topic.upsert.enable


  • 默认值：false
  • 限制值：布尔值
  • 支持自定义修改

控制是否启用 Table Topic 的 Upsert 功能。开启后，系统会根据主键自动判断是插入新记录还是更新已有记录。


automq.table.topic.partition.by


  • 默认值：1 天
  • 限制值：字符串
  • 支持自定义修改

定义 Table Topic 的分区规则，通过字段或函数对数据进行分区。例如 [bucket(name), month(timestamp)] 表示先按 name 字段的哈希分桶，再按 timestamp 的月份分区。


automq.table.topic.id.columns


  • 默认值：无
  • 限制值：字符串
  • 支持自定义修改

指定表的唯一主键列（复合主键），用于标识行级数据。值为以逗号分隔的列组合，例如 [region, name] 表示联合主键由 region 和 name 列组成。


automq.table.topic.cdc.field


  • 默认值：无
  • 限制值：字符串
  • 支持自定义修改

指定记录 CDC（Change Data Capture）操作类型的字段名称。用于标识数据库变更操作类型，值为单个字符 I 、 U 或 D ，分别对应数据的插入、更新和删除动作。


automq.table.topic.schema.type


  • 默认值：schemaless
  • 限制值：
    • schema
    • schemaless
      • 创建时配置，后续不支持修改

支持两种模式： schemaless （不解析消息内容，仅根据 Kafka 消息本身的 Schema 写入）和 schema （需在 schema registry 预定义消息 value 的 Schema，并根据该 Schema 写入到 Iceberg 中）。


资源配额限制​

AutoMQ Cloud 基于大规模生产环境的运维经验考虑，对产品内部分性能指标和参数做了初始约束，大部分情况下默认约束范围都是满足需求的，如有特殊情况不满足，请及时提工单寻求帮助。

环境类公共资源配额限制​

限制项
限制值
说明

单环境内允许的产品实例总数量


参考订阅计划版本约束


如当前限制有不满足，通过工单寻求帮助 获取人工服务▸ 。


单环境内成员账号数量


100 个


实例配额限制​

AutoMQ Cloud 基于大规模生产环境的运维经验考虑，对产品内部分性能指标和参数做了初始约束，大部分情况下默认约束范围都是满足需求的，如有特殊情况不满足，请及时提工单寻求帮助。

限制项
限制值
说明

单实例（集群）计算规格


3AKU ~ 500AKU，提供如下能力：


  • 写吞吐：60MBps~10000MBps
  • 读吞吐：60MBps~10000MBps

实例计算规格代表了单个实例（集群）收发消息处理的吞吐能力上限。


如有更大规模集群诉求，请 获取人工服务▸ 申请开放高规格限制。


单实例 Topic 数量上限


由创建实例的计算规格决定，具体参考规格限制 BYOC 计费说明▸ 。


从安全性和稳定性考虑，建议将不同业务拆分到不同实例中，避免所有业务集中在单个实例中。


单实例（集群）分区数上限


单实例（集群）请求 QPS 上限


BYOC 版开服区域限制​

代码
名称
us-east-1
US East (N. Virginia)
us-east-2
US East (Ohio)
us-west-1
US West (N. California)
us-west-2
US West (Oregon)
af-south-1
Africa (Cape Town)
ap-east-1
Asia Pacific (Hong Kong)
ap-south-2
Asia Pacific (Hyderabad)
ap-southeast-3
Asia Pacific (Jakarta)
ap-southeast-5
Asia Pacific (Malaysia)
ap-southeast-4
Asia Pacific (Melbourne)
ap-south-1
Asia Pacific (Mumbai)
ap-northeast-3
Asia Pacific (Osaka)
ap-northeast-2
Asia Pacific (Seoul)
ap-southeast-1
Asia Pacific (Singapore)
ap-southeast-2
Asia Pacific (Sydney)
ap-northeast-1
Asia Pacific (Tokyo)
ca-central-1
Canada (Central)
ca-west-1
Canada West (Calgary)
cn-north-1
China (Beijing)
cn-northwest-1
China (Ningxia)
eu-central-1
Europe (Frankfurt)
eu-west-1
Europe (Ireland)
eu-west-2
Europe (London)
eu-south-1
Europe (Milan)
eu-west-3
Europe (Paris)
eu-south-2
Europe (Spain)
eu-north-1
Europe (Stockholm)
eu-central-2
Europe (Zurich)
il-central-1
Israel (Tel Aviv)
me-south-1
Middle East (Bahrain)
me-central-1
Middle East (UAE)
sa-east-1
South America (São Paulo)