Getting Started

Azure Storage Queues Transport

Azure Storage Queues is a service hosted on the Azure platform, used for storing large numbers of messages. The messages can be accessed from anywhere in the world via authenticated calls using HTTP or HTTPS.

Azure Storage Queues are designed for very large cloud networks or hybrid networks, providing a highly reliable and inexpensive queuing service. A single message can be up to 64 KB in size and a queue can hold millions of messages, up to the total capacity limit of the storage account (200 TB). Furthermore, it is capable to emulate local transactions using its queue Peek-Lock mechanism.

The main disadvantages of this service is latency introduced by remoteness and the fact that it supports only HTTP-based communication.

As part of the Azure support for NServiceBus, one can choose between two transports provided by the Azure platform: Azure Storage Queues and Azure Service Bus. Each of them has different features, capabilities, and usage characteristics. A detailed comparison and discussion of when to select which is beyond the scope of this document. To help decide which option best suits the application's needs, refer to the Azure Queues and Azure Service Bus Queues - Compared and Contrasted article.

When considering an Azure Transport it is important to consider the transaction guarantees that that service provides.

Transport at a glance

TransactionsNone, ReceiveOnly (Message visibility timeout)
Pub/SubNative (Requires Storage Table)
TimeoutsNative (Requires Storage Table)
Large message bodiesData bus
Scale-outCompeting consumer
Scripted DeploymentNot supported
Native integrationSupported

Configuring the endpoint

To use Azure Storage Queues as the underlying transport configure it as follows:

var connectionString = "DefaultEndpointsProtocol=https;AccountName=[ACCOUNT];AccountKey=[KEY];";

var transport = endpointConfiguration.UseTransport<AzureStorageQueueTransport>();
transport.UseQueueServiceClient(new QueueServiceClient(connectionString));

//Blob client does not need to be specified if native delayed delivery is disabled

var account = CloudStorageAccount.Parse(connectionString);
transport.UseCloudTableClient(new CloudTableClient(account.TableStorageUri, account.Credentials));
transport.UseBlobServiceClient(new BlobServiceClient(connectionString));

//Or alternatively

Then set up appropriate connection strings.

When using Azure Storage Queues transport, a serializer must be configured explicitly by the UseSerialization API.


Related Articles