More than 3 years have passed since last update.

AzureServiceBus接続文字列で設定できること

Posted at 2020-04-19

Azure Storage 接続文字列について

Azure Storageに接続する際に使用する文字列です。
基本的には以下のように、アカウント名やアカウントキー等を" ; "区切りで、" = "で指定すると対象のアカウントにアクセスが出来ます。

DefaultEndpointsProtocol=[http|https];AccountName=myAccountName;AccountKey=myAccountKey;

Blob Storage, Table Storage, Queue Storage, Service Bus Storage等のストレージ系のサービスでそれぞれ接続文字列が用意されています。
今回はServiceBusの接続文字列で設定できるものについてまとめます。

JavaのSDK内でこの接続文字列を解釈しているConnectionStringBuilderのコード読んでみると、どうやらアクセスキーの設定以外にも色々な設定ができるみたいなので、どんな設定が可能かを以下にまとめます。

ServiceBusのエンドポイント。以下の形式。
sb://[NAMESPACE名].servicebus.windows.net

Endpoint=sb://myEndpoint.servicebus.windows.net;

エンドポイントにAMQPSプロトコルでの接続を行う際に使用する。
内部で"amqps://%s"でフォーマットされる。

Hostname=myHostname;

SharedAccessKeyの名前

SharedAccessKeyName=RootManagerSharedAccessKey;

SharedAccessKeyのキー値

SharedAccessKey=[KEYの値];

SharedAccessSignature トークン

SharedAccessSignatureToken=[TOKENの値];

Queue, Topic, Subscription のパス名

EntityPath=myQueue;

タイムアウト時間の設定値。
ISO-8601デュレーション・フォーマットPnDTnHnMn.nSベースで指定する。
何も指定しないと、デフォルトで30秒が設定される。

OperationTimeout=P1D1H1M1.001S

DefaultもしくはNoRetryを指定する。
デフォルトのRetryPolicyは、3秒間隔で最大5回リトライされる。

RetryPolicy=Default;

ServiceBusの接続文字列では、基本的なアクセス情報の指定だけでなく、タイムアウトやリトライの設定が可能です。