Registry / azure / azure-storage-blob-changefeed

azure-storage-blob-changefeed

library12.0.0b5pypypi✓ verified 83d ago

Client library for consuming the Azure Blob Storage Change Feed. Provides a ChangeFeedClient to list and process events from the change feed. Currently at version 12.0.0b5 (beta), with an irregular release cadence. Requires azure-storage-blob as a peer dependency.

azure data type-stubs

pip install azure-storage-blob-changefeed==12.0.0b5

github ↗package ↗

INSTALL

IMPORT

SIG · AZURE-STORAGE-BLOB

azure-storage-blob-changefeed

azurepythonv12.0.0b5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ChangeFeedClient

✓ from azure.storage.blob.changefeed import ChangeFeedClient

✗ from azure.storage.blob.changefeed import BlobChangeFeedClient

The class is named ChangeFeedClient, not BlobChangeFeedClient.

Initialize a ChangeFeedClient with a BlobServiceClient and DefaultAzureCredential, then iterate over change feed events.

import os from azure.storage.blob import BlobServiceClient from azure.storage.blob.changefeed import ChangeFeedClient from azure.identity import DefaultAzureCredential account_url = os.environ.get('STORAGE_ACCOUNT_URL', 'https://mystorageaccount.blob.core.windows.net') credential = DefaultAzureCredential() blob_service_client = BlobServiceClient(account_url=account_url, credential=credential) change_feed_client = ChangeFeedClient(blob_service_client=blob_service_client) # List change feed events (iterates over all events from the beginning) for event in change_feed_client.list_changes(): print(event.event_type, event.event_time) # Process event break

Debug

Known issues

deprecatedThe library is in beta (12.0.0b5) and the API may change. The ChangeFeedClient API has changed since early previews.

fix

Pin to the exact beta version and test upgrades carefully.

affects: >=12.0.0b1

gotchaRequires azure-storage-blob >=12.x installed separately. It's not pulled automatically.

fix

Run: pip install azure-storage-blob

affects: all

gotchaChangeFeedClient expects a BlobServiceClient, not a connection string directly. Common mistake is to pass a connection string or BlobServiceClient from a different version.

fix

Create a BlobServiceClient first, then pass it to ChangeFeedClient.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'ChangeFeedClient' from 'azure.storage.blob.changefeed'

The module is not installed or pip package is missing.

fix

Install the package: pip install azure-storage-blob-changefeed==12.0.0b5

AttributeError: 'ChangeFeedClient' object has no attribute 'list_changes'

The method may have been renamed or the API changed between beta versions.

fix

Check documentation for the installed version: dir(change_feed_client) to see available methods.

HttpResponseError: This operation is not supported for this storage account type

The storage account does not have the change feed feature enabled or is not a general-purpose v2 or BlobStorage account.

fix

Enable change feed in the Azure portal under Data protection > Change feed. Ensure account type is StorageV2 or BlobStorage.

Upgrade

Version history

12.0.0b5latest on PyPI · released Apr 16, 2024

Audit

Dependencies

azure-storage-blobrequiredRequired for authentication and BlobServiceClient.

azure-identityoptionalRecommended for DefaultAzureCredential usage.

Agent activity

32 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Azure/azure-sdk-for-python ↗

packagehttps://pypi.org/project/azure-storage-blob-changefeed/ ↗