azure-eventhub-checkpointstoreblob-aio

What it is and what it does

This package integrates Azure Blob Storage as a checkpoint store for async Event Hubs consumers. When processing events from Azure Event Hubs, consumers need to track their position (offset) within each partition so they can resume from the correct location after a restart or failover. This package provides the BlobCheckpointStore class, which persists that state in Azure Blob Storage blobs, allowing multiple consumer instances to coordinate partition ownership and maintain event stream position across restarts.

The package is designed as a plug-in for EventHubConsumerClient and handles the mechanics of storing and retrieving checkpoint data asynchronously. It depends on azure-eventhub for the consumer client interface and aiohttp for async HTTP operations. It is the async-only variant; a synchronous version exists separately.

Use it for:

• Distributed event processing where multiple consumer instances need to coordinate partition assignment and resume from the last processed offset after restarts.
• Building resilient event pipelines that can survive consumer failures without losing or replaying large event batches.
• Implementing event stream replay by resetting checkpoints to earlier offsets when reprocessing is needed.
• Auditing and compliance scenarios where you need persistent records of which events have been processed by which consumer groups.
• Multi-region or multi-instance deployments where checkpoint state must be shared across consumer instances via a durable store.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Stores checkpoints and partition ownership for Azure Event Hubs consumers using Azure Blob Storage as the persistent backend, enabling async event processing with automatic failover and replay capability.

Yes. This is a stable, actively maintained package from Microsoft's official Azure SDK with no known vulnerabilities, low install friction, and a permissive MIT license. Install it if you are building an async Event Hubs consumer application and need reliable checkpoint persistence—it is the standard way to do so on Azure.

Install

azure-eventhub-checkpointstoreblob-aio on PyPI

pip install azure-eventhub-checkpointstoreblob-aio

uv add azure-eventhub-checkpointstoreblob-aio

poetry add azure-eventhub-checkpointstoreblob-aio

Installing azure-eventhub-checkpointstoreblob-aio

Before you install

Low friction install with six runtime dependencies, all from the Azure SDK ecosystem. Actively maintained with recent releases; the repo is current and has substantial community engagement.

License in practice

MIT License permits commercial and private use with minimal restrictions—you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart

pip install azure-eventhub-checkpointstoreblob-aio

from azure.eventhub.aio import EventHubConsumerClient
from azure.eventhub.extensions.checkpointstoreblobaio import BlobCheckpointStore

checkpoint_store = BlobCheckpointStore.from_connection_string(
    storage_connection_str, container_name
)
client = EventHubConsumerClient.from_connection_string(
    connection_str, consumer_group,
    eventhub_name=eventhub_name,
    checkpoint_store=checkpoint_store
)

Requires Python 3.8 or later; requires active Azure Event Hubs namespace, Event Hub, and Azure Storage Blob container with appropriate connection strings.

Verify before relying

• Performance characteristics when checkpointing at scale (e.g., throughput, latency impact per partition).
• Behavior and recovery time when storage connectivity is temporarily lost during event processing.
• Whether the package supports custom storage API versions beyond the default 2019-07-07.

Package facts

Evidence: azure_eventhub_checkpointstoreblob_aio-1.2.0-py3-none-any.whl

Keywords: azure, azure sdk

Tags

More Distributed Computing packages