tencent cloud

消息队列 RabbitMQ 版

动态与公告
新功能发布记录
公告
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 RabbitMQ 版
产品优势
应用场景
开源托管版与 Serverless 版差异说明
开源版本支持说明
与开源 RabbitMQ 对比
高可用
使用限制
RabbitMQ 相关概念
开区地域
相关云服务
产品计费
计费概述
价格说明
计费示例
按小时付费转包年包月
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
步骤1:准备工作
步骤2:创建 RabbitMQ 集群
步骤3:配置 Vhost
步骤4:使用 SDK 收发消息
步骤5:查询消息
步骤6:销毁资源
用户指南
使用流程指引
配置账号权限
创建集群
配置 Vhost
连接集群
管理消息
配置高级特性
管理集群
查看监控和配置告警
实践教程
实践教程使用说明
RabbitMQ 客户端实践教程
RabbitMQ 消息可靠性实践教程
RabbitMQ 支持 MQTT 协议说明
迁移集群
迁移方案概述
步骤1:购买云上实例
步骤2:迁移元数据上云
步骤3:开启双读写
API 参考(开源托管版)
API 概览
API 参考(Serverless 版)
History
Introduction
API Category
Making API Requests
Relevant APIs for RabbitMQ Serverless PAAS Capacity
RabbitMQ Serverless Instance Management APIs
Data Types
Error Codes
SDK 文档
SDK 概述
Spring Boot Starter 接入
Spring Cloud Stream 接入
Java SDK
Go SDK
Python SDK
PHP SDK
安全与合规
权限管理
网络安全
删除保护
变更记录
云 API 审计
常见问题
服务等级协议
联系我们

Python SDK

PDF
聚焦模式
字号
最后更新时间: 2026-01-04 15:32:35

操作场景

本文以调用 Python SDK 为例介绍通过开源 SDK 实现消息收发的操作过程,帮助您更好地理解消息收发的完整过程。

前提条件

已参考 SDK 概述,获取相关的客户端连接参数

操作步骤

步骤1:添加依赖

1. 根据 RabbitMQ 官网推荐使用 pika,首先要在客户端使用环境中安装 pika。
python -m pip install pika --upgrade
2. 在创建客户端时导入 pika。
import pika

步骤2:生产消息

创建并编译运行生产消息程序 messageProducer.py。
import pika

# 使用用户名和密码创建登录凭证对象
credentials = pika.PlainCredentials('rolename', 'eyJr***')
# 创建连接
connection = pika.BlockingConnection(pika.ConnectionParameters(
host='111.222.333.44', port=5672, virtual_host='Vhostname', credentials=credentials))
# 建立信道
channel = connection.channel()
# 声明交换机
channel.exchange_declare(exchange='ExchangeName', exchange_type="ExchangeType")

routingKeys = ['aaa.bbb.ccc', 'aaa.bbb.ddd', 'aaa.ccc.zzz', "xxx.yyy.zzz"]

for routingKey in routingKeys:
# 发送消息到指定的交换机
# 不指定交换机的情况下发送消息,需要指定消息队列,参数routing_key在使用指定交换机时,表示routing_key,不指定交换机时代表消息队列名称
channel.basic_publish(exchange='direct_exchange',
routing_key=routingKey,
body=(routingKey + 'This is a new direct message.').encode(),
properties=pika.BasicProperties(
delivery_mode=2, # 设置消息持久化
))
print('send success msg to rabbitmq')
connection.close()
参数
说明
rolename
用户名称,填写在控制台创建的用户名称。
eyJr***
用户密码,填写在控制台创建用户时填写的密码。
host
集群接入地址,在集群基本信息页面的客户端接入模块获取。

port
集群接入地址端口,在集群基本信息页面的客户端接入模块获取。
virtual_host
Vhost 名称,在控制台 Vhost 列表获取。
direct_exchange
Exchange 名称,在控制台 Exchange 列表获取。
routingKeys
消息的路由规则,在控制台 绑定关系列表的绑定 Key列获取。
img



步骤3:消费消息

创建并编译运行消费消息程序 messageConsumer.py。
import os
import pika
import sys


def main():
# 使用用户名和密码创建登录凭证对象
credentials = pika.PlainCredentials('rolename', 'eyJr***')
# 创建连接
connection = pika.BlockingConnection(pika.ConnectionParameters(
host='111.222.333.44', port=5672, virtual_host='Vhostname', credentials=credentials))
# 建立信道
channel = connection.channel()
# 声明消息队列
channel.queue_declare(queue='route_queue1', exclusive=True, durable=True)
# 绑定消息队列到交换机,并指定 routing key
routing_keys = ['aaa.bbb.ccc', 'aaa.bbb.ddd']
for routingKey in routing_keys:
channel.queue_bind(exchange='direct_exchange', queue="route_queue1", routing_key=routingKey)
# 设置只接受一个未确认消息
channel.basic_qos(prefetch_count=1)

# 消息消费逻辑
def callback(ch, method, properties, body):
print(" [Consumer1(Direct 'aaa.bbb.ccc'/'aaa.bbb.ddd')] Received (%r)" % body)
# 手动回复ACK
ch.basic_ack(delivery_tag=method.delivery_tag)

# 创建消费者,消费消息队列中的消息
channel.basic_consume(queue='route_queue1',
on_message_callback=callback,
auto_ack=False) # 设置为非自动确认

print(" [Consumer1(Direct 'aaa.bbb.ccc'/'aaa.bbb.ddd')] Waiting for messages. To exit press CTRL+C")
channel.start_consuming()


if __name__ == '__main__':
try:
main()
except KeyboardInterrupt:
print('Interrupted')
try:
sys.exit(0)
except SystemExit:
os._exit(0)
参数
说明
rolename
用户名称,填写在控制台创建的用户名称。
eyJr***
用户密码,填写在控制台创建用户时填写的密码。
host
集群接入地址,在集群基本信息页面的 客户端接入 模块获取。

port
集群接入地址端口,在集群基本信息页面的 客户端接入 模块获取。
virtual_host
Vhost 名称,在控制台 Vhost 列表获取。
direct_exchange
Exchange 名称,在控制台 Exchange 列表获取。
route_queue1
Queue名称,在控制台 Queue 列表获取。
routingKey
消息的路由规则,在控制台 绑定关系列表的绑定 Key列获取。
img



步骤4:查看消息

如果您想确认消息是否成功发送至 TDMQ RabbitMQ 版,可以在控制台 集群管理 > Queue 基本信息页面查看接入的消费者情况。

说明:
完整示例或其他使用可参见 Demo 或者 RabbitMQ 官方使用文档

帮助和支持

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

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

文档反馈