云消息队列 RocketMQ 版：Topic导入/导出

注意事项

• Topic导入或导出支持跨实例系列，例如，您可以将4.x系列实例的Topic列表导出然后导入至5.x系列的实例中。

• Topic导入或导出操作仅涉及Topic资源的基础信息，例如，Topic名称、Topic的消息类型、Topic的描述信息，不涉及Topic中消息数据的变更或迁移。

• 导入Topic时，Topic列表必须符合模板要求，具体规范，请参见Topic列表模板。

Topic导出

1. 登录云消息队列 RocketMQ 版控制台，在左侧导航栏单击实例列表。

2. 在顶部菜单栏选择地域，如华东1（杭州），然后在实例列表中，单击目标实例名称。

3. 在左侧导航栏单击Topic 管理。

4. 在Topic 管理页面右上角单击图标。

   系统会自动将该实例下的Topic资源列表数据导出并保存为.xlsx文件。

Topic导入

您可以将已导出的Topic列表直接导入至目标实例中，也可以根据实际需求更新列表内容再导入Topic信息。

1. 登录云消息队列 RocketMQ 版控制台，在左侧导航栏单击实例列表。

2. 在顶部菜单栏选择地域，如华东1（杭州），然后在实例列表中，单击目标实例名称。

3. 在左侧导航栏单击Topic 管理。

4. 在Topic 管理页面右上角单击图标。

5. 选择在本地保存的Topic资源列表文件，然后单击打开。

   待导入的Topic资源列表的模板规范如下：

   模板参数	说明	取值限制
   TopicName	Topic名称。	字符限制：支持字母a~z或A~Z、数字0~9以及下划线（_）和短划线（-）。 长度限制： Serverless系列实例：1~128个字符。 非Serverless系列实例：1~60个字符。 Topic不能使用保留字符或特殊前缀字符命名，具体限制，请参见参数 限制值 说明 实例名称 字符限制：仅支持中文、字母a~z或A~Z、数字0~9和下划线（_）。 长度限制：1~128个字符。 无。 Topic名称 字符限制：支持字母a~z或A~Z、数字0~9以及下划线（_）和短划线（-）。 长度限制： Serverless系列实例：1~128个字符。 非Serverless系列实例：1~60个字符。 系统保留字符：Topic名称不允许使用以下保留字符或含有特殊前、后缀的字符命名。 保留字符 TBW102 BenchmarkTest SELF_TEST_TOPIC OFFSET_MOVED_EVENT SCHEDULE_TOPIC_XXXX RMQ_SYS_TRANS_HALF_TOPIC RMQ_SYS_TRACE_TOPIC RMQ_SYS_TRANS_OP_HALF_TOPIC 特殊前缀 rmq_sys_ %RETRY% %DLQ% rocketmq-broker- rocketmq-proxy- 特殊后缀 _REPLY_TOPIC Topic命名应该尽量使用简短、常用的字符，避免使用特殊字符。特殊字符会导致系统解析出现异常，字符过长可能会导致消息收发被拒绝。 LiteTopic名称 字符限制：支持字母a~z或A~Z、数字0~9以及下划线（_）和短划线（-）。 长度限制：1~64个字符。 LiteTopic命名应该尽量使用简短、常用的字符，避免使用特殊字符。特殊字符会导致系统解析出现异常，字符过长可能会导致消息收发被拒绝。 LiteTopic过期时间 默认值：用户必填参数，无默认值。 取值范围：30~720 或 -1，单位为分钟，整数。-1 表示不会过期。 当前主题下轻量主题资源过期时间。当该主题下的任意轻量主题持续没有新的消息写入，时长达到轻量主题过期时间后，该轻量主题会过期并被自动删除。如值为 -1 ，则代表轻量主题不会过期，会持续存在不被删除。当消息类型为 Lite 时，可以设置此字段。 ConsumerGroup名称 字符限制：支持字母a~z或A~Z、数字0~9以及下划线（_）和短划线（-）。 长度限制： Serverless系列实例：1~128个字符。 非Serverless系列实例：1~60个字符。 系统保留字符：ConsumerGroup不允许使用以下保留字符或含有特殊前缀的字符命名。 保留字符 DEFAULT_CONSUMER DEFAULT_PRODUCER TOOLS_CONSUMER FILTERSRV_CONSUMER __MONITOR_CONSUMER CLIENT_INNER_PRODUCER SELF_TEST_P_GROUP SELF_TEST_C_GROUP CID_ONS-HTTP-PROXY CID_ONSAPI_PERMISSION CID_ONSAPI_OWNER CID_ONSAPI_PULL CID_RMQ_SYS_TRANS 特殊字符 CID_RMQ_SYS_ CID_HOUSEKEEPING 无。 实例备注 字符限制：仅支持中文、字母a~z或A~Z、数字0~9和下划线（_）。 长度限制：1~256个字符。 无。 Topic备注 Group备注 ACL Credentials 字符限制：AK（AccessKey ID）、SK（AccessKey Secret）和Token仅支持字母a~z或A~Z、数字0~9。 长度限制：不超过1024个字符。 无。 请求超时时间 默认值：3000毫秒。 取值范围：该参数为客户端本地行为，取值范围不做限制。 请求超时时间是客户端本地同步调用的等待时间，请根据实际应用设置合理的取值，避免线程阻塞时间过长。 消息大小 不超过4 MB。 不涉及消息压缩，仅计算消息体body的大小。 消息传输应尽量压缩和控制负载大小，避免超大文件传输。若消息大小不满足限制要求，可以尝试分割消息或使用OSS存储，用消息传输URL。特殊消息大小支持，可提工单支持。 消息自定义属性 字符限制：所有可见字符。 数量限制：每条消息最多可设置128个属性。 长度限制：属性的Key和Value总长度不超过16 KB。 系统保留属性：不允许使用以下保留属性作为自定义属性的Key。 保留属性Key TRACE_ON MSG_REGION KEYS TAGS DELAY RETRY_TOPIC REAL_TOPIC REAL_QID TRAN_MSG PGROUP MIN_OFFSET MAX_OFFSET BUYER_ID ORIGIN_MESSAGE_ID TRANSFER_FLAG CORRECTION_FLAG MQ2_FLAG RECONSUME_TIME UNIQ_KEY MAX_RECONSUME_TIMES CONSUME_START_TIME POP_CK POP_CK_OFFSET 1ST_POP_TIME TRAN_PREPARED_QUEUE_OFFSET DUP_INFO EXTEND_UNIQ_INFO INSTANCE_ID CORRELATION_ID REPLY_TO_CLIENT TTL ARRIVE_TIME PUSH_REPLY_TIME CLUSTER MSG_TYPE INNER_MULTI_QUEUE_OFFSET _BORNHOST __LITE_TOPIC 无。 MessageGroup 字符限制：所有可见字符。 长度限制：1~64字节。 MessageGroup是顺序消息的分组标识。一般设置为需要保证顺序的一组消息标识，例如订单ID、用户ID等。 消息发送重试次数 默认值：3次。 取值范围：无限制。 消息发送重试是客户端SDK内置的重试策略，对应用不可见，建议取值不要过大，避免阻塞业务线程。 如果消息达到最大重试次数后还未发送成功，建议业务侧做好兜底处理，保证消息可靠性。 消息消费重试次数 默认值：16次。 最大限制：不超过1000次。 消费重试次数应根据实际业务需求设置合理的参数值，避免使用重试进行无限触发。重试次数过大容易造成系统压力过量增加。 事务异常检查间隔 默认值：60秒。 取值范围：不支持自定义修改。 事务异常检查间隔指的是，半事务消息因系统重启或异常情况导致没有提交，生产者客户端会按照该间隔时间进行事务状态回查。 间隔时长不建议设置过短，否则频繁的回查调用会影响系统性能。 半事务消息第一次回查时间 默认值：取值等于[事务异常检查间隔] 最大限制：不超过1小时。 无。 半事务消息最大超时时长 默认值：4小时。 取值范围：不支持自定义修改。 半事务消息因系统重启或异常情况导致没有提交，生产者客户端会按照事务异常检查间隔时间进行回查，若超过半事务消息超时时长后没有返回结果，半事务消息将会被强制回滚。 您可以通过监控该指标避免异常事务。 定时消息最大间隔 非Serverless系列（包年包月、按量付费） 标准版：7天。 专业版、铂金版：40天。 Serverless系列 存量标准版、专业版：7天。 共享：7天。 独享：7天。可提工单修改，修改后不可降配到共享实例。 定时消息间隔时长建议使用小时级别的时间区间，避免长时间定时。 PushConsumer消费超时时长 默认值：230分钟。 取值范围：系统级配置，不支持修改。 PushConsumer消费超时时长由云消息队列 RocketMQ 版服务端统一控制。 超过消费超时时长消息还未处理完成，将被系统强制判定为消费失败并进行重试，因此可能会导致少量消息重复。 PushConsumer本地缓存 默认值： 最大缓存数量：1024条。 最大缓存大小：64 M。 取值范围：支持用户自定义设置，无限制。 消费者类型为PushConsumer时，为提高消费者吞吐量和性能，客户端会在SDK本地缓存部分消息。缓存的消息的数量和大小应设置在系统内存允许的范围内。 PushConsumer重试间隔时长 默认值： 非顺序性投递：间隔时间阶梯变化，具体取值，请参见。 顺序性投递：1000毫秒。 取值范围：不支持自定义修改。 无。 PushConsumer消费并发度 默认值：20个线程。 取值范围：支持用户自定义设置，无限制。 无。 获取消息最大批次 默认值：32条。 取值范围：系统级配置，不支持修改。 消费者从服务端获取消息时，一次获取到最大消息条数。建议按照实际业务设置合理的参数值，一次获取消息数量过大容易在消费失败时造成大批量消息重复。 SimpleConsumer最大不可见时间 默认值：用户必填参数，无默认值。 取值范围：最小10秒；最大12小时。 消费不可见时间指的是消息处理+失败后重试间隔的总时长，建议设置时取值比实际需要耗费的时间稍微长一些。 消费者长轮询超时时间 取值范围：最小值5秒，最大值20秒。 支持用户在取值范围内自定义调整。 设置长轮询超时时间后，如果当前服务端无已就绪的消息，客户端请求会阻塞直到新消息到达或者超时时间到达。 消费者使用长轮询可以在消息量少的情况下大幅降低无效的空请求，降低客户端和服务端的压力。 订阅关系 过滤表达式长度限制：4000个字符（包括TAG过滤和SQL过滤）。 订阅关系的详细信息，请参见。。
   MessageType	Topic的消息类型。	取值如下： TRANSACTION：事务消息 DELAY：定时/延时消息 FIFO：顺序消息 NORMAL：普通消息
   Remark	Topic的备注信息。	长度限制为1~60字符。

   模板内容示例如下：

   TopicName	MessageType	Remark
   Topic1	TRANSACTION	用于发送事务消息
   Topic2	NORMAL	用于发送普通消息
   Topic3	DELAY	用于发送延时消息

6. 在弹出的导入资源列表面板中，选中待导入的Topic，在其操作列单击确认并导入。

   您也可以选中多个Topic，然后单击批量导入。

   导入成功后，Topic列表中执行结果列变为已导入。

7. 在导入资源列表面板左下角单击确定完成导入。

   导入完成后，选中的待导入的Topic会出现在Topic列表中。

相关文档

• 如果您需要同时跨实例同步Group的列表信息，请参见Group导入/导出。

• 如果您需要迁移自建RockketMQ集群的数据到阿里云的云消息队列 RocketMQ 版上，请参见自建RocketMQ集群迁移上云。