[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-04a8dc00-d3b8-4a3d-ac2d-782a1ea47e43":3,"$fK7D-xRr7ZrEyJiJetVfgGPD5sgH7Nq0Jlyr8qjkoN-0":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"04a8dc00-d3b8-4a3d-ac2d-782a1ea47e43","azure-servicebus-py","Azure Service Bus Python SDK 消息。用于队列、主题、订阅和企业消息模式。","cat_coding_devops","mod_coding","sickn33,coding","---\nname: azure-servicebus-py\ndescription: Azure Service Bus SDK for Python messaging. Use for queues, topics, subscriptions, and enterprise messaging patterns.\nrisk: unknown\nsource: community\ndate_added: '2026-02-27'\n---\n\n# Azure Service Bus SDK for Python\n\nEnterprise messaging for reliable cloud communication with queues and pub\u002Fsub topics.\n\n## Installation\n\n```bash\npip install azure-servicebus azure-identity\n```\n\n## Environment Variables\n\n```bash\nSERVICEBUS_FULLY_QUALIFIED_NAMESPACE=\u003Cnamespace>.servicebus.windows.net\nSERVICEBUS_QUEUE_NAME=myqueue\nSERVICEBUS_TOPIC_NAME=mytopic\nSERVICEBUS_SUBSCRIPTION_NAME=mysubscription\n```\n\n## Authentication\n\n```python\nfrom azure.identity import DefaultAzureCredential\nfrom azure.servicebus import ServiceBusClient\n\ncredential = DefaultAzureCredential()\nnamespace = \"\u003Cnamespace>.servicebus.windows.net\"\n\nclient = ServiceBusClient(\n    fully_qualified_namespace=namespace,\n    credential=credential\n)\n```\n\n## Client Types\n\n| Client | Purpose | Get From |\n|--------|---------|----------|\n| `ServiceBusClient` | Connection management | Direct instantiation |\n| `ServiceBusSender` | Send messages | `client.get_queue_sender()` \u002F `get_topic_sender()` |\n| `ServiceBusReceiver` | Receive messages | `client.get_queue_receiver()` \u002F `get_subscription_receiver()` |\n\n## Send Messages (Async)\n\n```python\nimport asyncio\nfrom azure.servicebus.aio import ServiceBusClient\nfrom azure.servicebus import ServiceBusMessage\nfrom azure.identity.aio import DefaultAzureCredential\n\nasync def send_messages():\n    credential = DefaultAzureCredential()\n    \n    async with ServiceBusClient(\n        fully_qualified_namespace=\"\u003Cnamespace>.servicebus.windows.net\",\n        credential=credential\n    ) as client:\n        sender = client.get_queue_sender(queue_name=\"myqueue\")\n        \n        async with sender:\n            # Single message\n            message = ServiceBusMessage(\"Hello, Service Bus!\")\n            await sender.send_messages(message)\n            \n            # Batch of messages\n            messages = [ServiceBusMessage(f\"Message {i}\") for i in range(10)]\n            await sender.send_messages(messages)\n            \n            # Message batch (for size control)\n            batch = await sender.create_message_batch()\n            for i in range(100):\n                try:\n                    batch.add_message(ServiceBusMessage(f\"Batch message {i}\"))\n                except ValueError:  # Batch full\n                    await sender.send_messages(batch)\n                    batch = await sender.create_message_batch()\n                    batch.add_message(ServiceBusMessage(f\"Batch message {i}\"))\n            await sender.send_messages(batch)\n\nasyncio.run(send_messages())\n```\n\n## Receive Messages (Async)\n\n```python\nasync def receive_messages():\n    credential = DefaultAzureCredential()\n    \n    async with ServiceBusClient(\n        fully_qualified_namespace=\"\u003Cnamespace>.servicebus.windows.net\",\n        credential=credential\n    ) as client:\n        receiver = client.get_queue_receiver(queue_name=\"myqueue\")\n        \n        async with receiver:\n            # Receive batch\n            messages = await receiver.receive_messages(\n                max_message_count=10,\n                max_wait_time=5  # seconds\n            )\n            \n            for msg in messages:\n                print(f\"Received: {str(msg)}\")\n                await receiver.complete_message(msg)  # Remove from queue\n\nasyncio.run(receive_messages())\n```\n\n## Receive Modes\n\n| Mode | Behavior | Use Case |\n|------|----------|----------|\n| `PEEK_LOCK` (default) | Message locked, must complete\u002Fabandon | Reliable processing |\n| `RECEIVE_AND_DELETE` | Removed immediately on receive | At-most-once delivery |\n\n```python\nfrom azure.servicebus import ServiceBusReceiveMode\n\nreceiver = client.get_queue_receiver(\n    queue_name=\"myqueue\",\n    receive_mode=ServiceBusReceiveMode.RECEIVE_AND_DELETE\n)\n```\n\n## Message Settlement\n\n```python\nasync with receiver:\n    messages = await receiver.receive_messages(max_message_count=1)\n    \n    for msg in messages:\n        try:\n            # Process message...\n            await receiver.complete_message(msg)  # Success - remove from queue\n        except ProcessingError:\n            await receiver.abandon_message(msg)  # Retry later\n        except PermanentError:\n            await receiver.dead_letter_message(\n                msg,\n                reason=\"ProcessingFailed\",\n                error_description=\"Could not process\"\n            )\n```\n\n| Action | Effect |\n|--------|--------|\n| `complete_message()` | Remove from queue (success) |\n| `abandon_message()` | Release lock, retry immediately |\n| `dead_letter_message()` | Move to dead-letter queue |\n| `defer_message()` | Set aside, receive by sequence number |\n\n## Topics and Subscriptions\n\n```python\n# Send to topic\nsender = client.get_topic_sender(topic_name=\"mytopic\")\nasync with sender:\n    await sender.send_messages(ServiceBusMessage(\"Topic message\"))\n\n# Receive from subscription\nreceiver = client.get_subscription_receiver(\n    topic_name=\"mytopic\",\n    subscription_name=\"mysubscription\"\n)\nasync with receiver:\n    messages = await receiver.receive_messages(max_message_count=10)\n```\n\n## Sessions (FIFO)\n\n```python\n# Send with session\nmessage = ServiceBusMessage(\"Session message\")\nmessage.session_id = \"order-123\"\nawait sender.send_messages(message)\n\n# Receive from specific session\nreceiver = client.get_queue_receiver(\n    queue_name=\"session-queue\",\n    session_id=\"order-123\"\n)\n\n# Receive from next available session\nfrom azure.servicebus import NEXT_AVAILABLE_SESSION\nreceiver = client.get_queue_receiver(\n    queue_name=\"session-queue\",\n    session_id=NEXT_AVAILABLE_SESSION\n)\n```\n\n## Scheduled Messages\n\n```python\nfrom datetime import datetime, timedelta, timezone\n\nmessage = ServiceBusMessage(\"Scheduled message\")\nscheduled_time = datetime.now(timezone.utc) + timedelta(minutes=10)\n\n# Schedule message\nsequence_number = await sender.schedule_messages(message, scheduled_time)\n\n# Cancel scheduled message\nawait sender.cancel_scheduled_messages(sequence_number)\n```\n\n## Dead-Letter Queue\n\n```python\nfrom azure.servicebus import ServiceBusSubQueue\n\n# Receive from dead-letter queue\ndlq_receiver = client.get_queue_receiver(\n    queue_name=\"myqueue\",\n    sub_queue=ServiceBusSubQueue.DEAD_LETTER\n)\n\nasync with dlq_receiver:\n    messages = await dlq_receiver.receive_messages(max_message_count=10)\n    for msg in messages:\n        print(f\"Dead-lettered: {msg.dead_letter_reason}\")\n        await dlq_receiver.complete_message(msg)\n```\n\n## Sync Client (for simple scripts)\n\n```python\nfrom azure.servicebus import ServiceBusClient, ServiceBusMessage\nfrom azure.identity import DefaultAzureCredential\n\nwith ServiceBusClient(\n    fully_qualified_namespace=\"\u003Cnamespace>.servicebus.windows.net\",\n    credential=DefaultAzureCredential()\n) as client:\n    with client.get_queue_sender(\"myqueue\") as sender:\n        sender.send_messages(ServiceBusMessage(\"Sync message\"))\n    \n    with client.get_queue_receiver(\"myqueue\") as receiver:\n        for msg in receiver:\n            print(str(msg))\n            receiver.complete_message(msg)\n```\n\n## Best Practices\n\n1. **Use async client** for production workloads\n2. **Use context managers** (`async with`) for proper cleanup\n3. **Complete messages** after successful processing\n4. **Use dead-letter queue** for poison messages\n5. **Use sessions** for ordered, FIFO processing\n6. **Use message batches** for high-throughput scenarios\n7. **Set `max_wait_time`** to avoid infinite blocking\n\n## Reference Files\n\n| File | Contents |\n|------|----------|\n| references\u002Fpatterns.md | Competing consumers, sessions, retry patterns, request-response, transactions |\n| references\u002Fdead-letter.md | DLQ handling, poison messages, reprocessing strategies |\n| scripts\u002Fsetup_servicebus.py | CLI for queue\u002Ftopic\u002Fsubscription management and DLQ monitoring |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,107,681,"2026-05-16 13:07:43",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"DevOps","devops","mdi-cog-outline","CI\u002FCD、容器化、部署运维",3,162,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"8640ec44-3086-44bf-94d7-69c9c87efa21","1.0.0","azure-servicebus-py.zip",2596,"uploads\u002Fskills\u002F04a8dc00-d3b8-4a3d-ac2d-782a1ea47e43\u002Fazure-servicebus-py.zip","4f41f045773d933fa60d41eeb9902e3a8bd139970bd9465c7dbeb27411f50f33","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":8325}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]