エンティティの統合

  • [アーティクル]

Merge Entity 操作は、エンティティのプロパティを更新することで既存のエンティティを更新します。 この操作は、エンティティの更新操作と同様に、既存の エンティティ を置き換えるものではありません。

要求

要求は Merge Entity 次のように構築できます。 HTTPS が推奨されます。 myaccount はストレージ アカウントの名前に、mytable はテーブルの名前に置き換えます。 myPartitionKey と myRowKey を、更新するエンティティを識別するパーティション キーと行キーの名前に置き換えます。

Method 要求 URI HTTP バージョン
MERGE https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

更新するエンティティのアドレスは、要求 URI に対してさまざまな形式を使用できます。 詳細については、 OData プロトコル に関するページを参照してください。

エミュレートされたストレージ サービス URI

エミュレートされたストレージ サービスに対して要求を行う場合は、エミュレーターのホスト名と Azure Table Storage ポートを として 127.0.0.1:10002指定し、その後にエミュレートされたストレージ アカウント名を指定します。

Method 要求 URI HTTP バージョン
MERGE http://127.0.0.1:10002/devstoreaccount1/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

ストレージ エミュレーターの Table Storage は、いくつかの点で Azure Table Storage とは異なります。 詳細については、「 ストレージ エミュレーターと Azure Storage サービスの違い」を参照してください。

URI パラメーター

要求 URI には、次の追加パラメーターを指定できます。

パラメーター 説明
timeout 省略可能。 timeout パラメーターは、秒単位で表されます。 詳細については、「 Table Storage 操作のタイムアウトの設定」を参照してください。

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー 説明
Authorization 必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
Date または x-ms-date 必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
x-ms-version 省略可能。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
Content-Type 必須。 ペイロードのコンテンツ タイプを指定します。 設定可能な値は application/atom+xml および application/json です。

有効なコンテンツ タイプの詳細については、「 Table Storage 操作のペイロード形式」を参照してください。
Content-Length 必須。 要求本文の長さです。
If-Match 必須。 クライアントは、オプティミスティック コンカレンシーを目的として、サービスによって管理されている と比較ETagするために、要求でエンティティの を指定ETagできます。 更新操作は、クライアントによって送信された が ETag サーバーによって管理される値と一致する場合にのみ実行されます。 この一致は、エンティティがクライアントによって取得されてから変更されていないことを示します。

無条件更新を強制するには、If-Match をワイルドカード文字 (*) に設定します。
x-ms-client-request-id 省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 詳細については、「 Azure Table Storage の監視」を参照してください。

要求本文

この操作により Merge Entity 、エンティティとして OData 更新されるエンティティが送信されます。これは、JSON または Atom フィードのいずれかになります。 詳細については、「 エンティティの挿入と更新」を参照してください。

[応答]

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

状態コード

操作が正常に終了すると、ステータス コード 204 (No Content) が返されます。 状態コードの詳細については、「 状態とエラー コード 」および 「Table Storage のエラー コード」を参照してください。

応答ヘッダー

この操作の応答には、次のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーを含めることもできます。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー 説明
ETag ETagエンティティの 。
x-ms-request-id このヘッダーは、行われた要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。
x-ms-version 要求の実行に使用される Table Storage のバージョンを示します。 このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。
Date 応答が開始された時刻を示す UTC 日付/時刻値。 サービスによってこの値が生成されます。
x-ms-client-request-id このヘッダーを使用して、要求と対応する応答のトラブルシューティングを行うことができます。 このヘッダーの値は、要求に存在する x-ms-client-request-id 場合は、ヘッダーの値と同じです。 この値は、表示可能な ASCII 文字が最大 1024 文字です。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。

応答本文

なし。

応答のサンプル

Response Status:  
HTTP/1.1 204 No Content  
  
Response Headers:  
Connection: Keep-Alive  
Content-Length: 0  
Cache-Control: no-cache  
Date: Mon, 25 Nov 2013 19:06:47 GMT  
ETag: W/"0x5B168C7B6E589D2"  
x-ms-version: 2013-08-15  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0

承認

アカウント所有者は、この操作を実行できます。 さらに、この操作を実行するアクセス許可を持つ共有アクセス署名を持つすべてのユーザーがこれを行うことができます。

注釈

Table Storage では、プロパティの値は永続的になりません null 。 値を持つプロパティを null 指定することは、要求でそのプロパティを省略することと同じです。 値以外のnull プロパティのみが操作によって Merge Entity 更新されます。

操作でプロパティ Merge Entity を削除することはできません。 これを行う必要がある場合は、 エンティティの更新 操作を呼び出してエンティティを置き換えます。

エンティティをマージするときは、マージ操作の PartitionKey 一部として および RowKey システム プロパティを指定する必要があります。

エンティティの ETag では、マージ操作に対して既定のオプティミスティック コンカレンシーが提供されます。 値は ETag 不透明であり、読み取ったり依存したりしないでください。 マージ操作が行われる前に、Table Storage はエンティティの現在ETagの値がヘッダーに要求If-MatchにETag含まれる値と同じであることを確認します。 値が同一の場合、Table Storage はエンティティが取得されてから変更されていないことを判断し、マージ操作を続行します。

エンティティ ETag がマージ要求で指定されたエンティティと異なる場合、マージ操作は状態コード 412 (前提条件失敗) で失敗します。 このエラーは、取得後にサーバーでエンティティが変更されたことを示します。 このエラーを解決するには、エンティティを取得して要求を再発行します。

無条件マージ操作を強制するには、要求で If-Match ヘッダーの値をワイルドカード文字 (*) に設定します。 この値を操作に渡すと、既定のオプティミスティック コンカレンシーがオーバーライドされ、値の ETag 不一致が無視されます。

If-Matchバージョン 2011-08-18 以降の要求にヘッダーがない場合、サービスはエンティティの挿入またはマージ (upsert) 操作を実行します。 2011-08-18 より前のバージョンでは、サービスは状態コード 400 (無効な要求) を返します。

要求を承認して送信 HTTP MERGE できるアプリケーションは、エンティティをマージできます。 を使用 HTTP MERGEしてクエリを作成する方法の詳細については、「 エンティティの追加、変更、削除」を参照してください。

バッチ マージ操作の実行については、「 エンティティ グループ トランザクションの実行」を参照してください。

関連項目

エンティティの更新
Azure Storage への要求を承認する
OData データ サービスのバージョン ヘッダーの設定
状態コードとエラー コード
Table Storage のエラー コード