エンティティグループトランザクションの実行

[アーティクル]
06/27/2023

同じテーブルに存在し、かつ同じパーティショングループに属しているエンティティについて、Table service はバッチトランザクションをサポートします。エンティティの複数挿入、エンティティの更新、エンティティのマージ、エンティティの削除、エンティティの挿入または置換、エンティティの挿入またはマージ操作は、1 つのトランザクション内でサポートされます。

エンティティグループトランザクションの要件

エンティティグループトランザクションは、次の要件を満たしている必要があります。

トランザクションに含まれる操作の対象となるすべてのエンティティが、同じ PartitionKey 値を持っている必要があります。
エンティティはトランザクション内に 1 回だけ出現でき、それに対して 1 つの操作しか実行できません。
トランザクションには最大 100 個のエンティティを含めることができます。そのペイロードの合計サイズは 4 MiB 以下です。
すべてのエンティティは、「 Table Service データモデルについて」で説明されている制限の対象となります。

テーブルサービスでの OData バッチ要求のサポート

エンティティグループトランザクションのセマンティクスは、 OData プロトコル仕様によって定義されます。 OData 仕様では、バッチ要求に関する次の概念が定義されています。

変更セットは、1 つ以上の挿入、更新、または削除操作のグループです。
バッチは操作のコンテナーであり、1 つ以上の変更セットおよびクエリ操作が含まれます。

テーブルサービスは、OData 仕様で定義される機能のサブセットをサポートします。

テーブルサービスは、1 つのバッチ内で 1 つの変更セットだけをサポートします。変更セットには、複数の挿入、更新、および削除操作を含めることができます。バッチに複数の変更セットが含まれている場合、最初の変更セットがサービスによって処理され、それ以外の変更セットはステータスコード 400 (Bad Request) で拒否されます。

重要

1 つの変更セット内に、1 つのエンティティに対する複数の操作を含めることはできません。

挿入、更新、または削除操作を含んでいるバッチにクエリ操作を含めることはできません。クエリ操作はバッチ内で単独で送信する必要があります。
変更セット内の操作はアトミックに処理されます。つまり、変更セット内のすべての操作が成功するか失敗します。操作は、変更セットに指定された順序で処理されます。
テーブルサービスは、変更セット内のリンク操作をサポートしていません。
テーブルサービスは、1 つの変更セット内で最大 100 個の操作をサポートします。

REST を使用したエンティティグループトランザクション

以下のセクションでは、バッチ要求を作成する方法とバッチ応答を解釈する方法について説明し、それぞれの例を示します。

バッチ要求の構文

REST 経由でバッチ要求を実行するには、要求 URI で $batch オプションを指定します。次に例を示します。

https://myaccount.table.core.windows.net/$batch

要求の URI にテーブル名が含まれていないことに注意してください。

バッチ要求は、1 つの POST ディレクティブでサーバーに送信されます。この要求には x-ms-version ヘッダーが含まれている必要があります。また、ヘッダーの値は 2009-04-14 以降に設定されていなければなりません。

XML ペイロードは、バッチおよび変更セットを含むマルチパート MIME メッセージです。ペイロードには次の 2 つの MIME 境界が含まれます。

バッチ境界。変更セットを包含します。
変更セット境界。バッチ内の個々の挿入、更新、および削除操作を区切ります。

変更セット内の個々の要求は、その操作が単独で呼び出されたときに作成される要求と同じです。次に例を示します。

更新、マージ、または削除操作に If-Match ヘッダーを指定するには、変更セット内の該当する操作の要求ヘッダーのセットに、このヘッダーを含めます。
変更セット内の各操作のペイロード形式 (JSON または ATOM) を指定するには、「Table Service Operations のペイロード形式」の詳細で説明されているように、適切な Content-Type、Accept、Versionおよび DataServiceVersion ヘッダーを含めます。
Insert Entity の応答コンテンツエコーを抑制するには、変更セット内のPrefer各挿入操作のreturn-no-content値を含むヘッダーを指定します。ヘッダーの Prefer 詳細については、「 Table Service の機能の概要」を参照してください。

挿入、更新、および削除操作の要求の例

次の例は、2 つのエンティティの挿入操作とエンティティのマージ操作を含むバッチ要求を示しています。これらの例では、挿入操作の応答でエコーペイロードに関心がないため、ヘッダーを Prefer:``return-no-content 含めます。

注意

JSON は推奨されるペイロード形式であり、バージョン 2015-12-11 以降でサポートされている唯一の形式です。

JSON (バージョン 2013-08-15 以降)

次の例は、JSON ペイロードを含むバッチ要求を示しています。

  
POST https://myaccount.table.core.windows.net/$batch HTTP/1.1  
x-ms-version: 2013-08-15  
Accept-Charset: UTF-8  
DataServiceVersion: 3.0;  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: multipart/mixed; boundary=batch_a1e9d677-b28b-435e-a89e-87e6a768a431  
x-ms-date: Mon, 14 Oct 2013 18:25:49 GMT  
Authorization: SharedKey myaccount:50daR38MtfezvbMdKrGJVN+8sjDSn+AaA=  
Host: 127.0.0.1:10002  
Content-Length: 1323  
Connection: Keep-Alive  
  
--batch_a1e9d677-b28b-435e-a89e-87e6a768a431  
Content-Type: multipart/mixed; boundary=changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
POST https://myaccount.table.core.windows.net/Blogs HTTP/1.1  
Content-Type: application/json  
Accept: application/json;odata=minimalmetadata  
Prefer: return-no-content  
DataServiceVersion: 3.0;  
  
{"PartitionKey":"Channel_19", "RowKey":"1", "Rating":9, "Text":".NET..."}  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
POST https://myaccount.table.core.windows.net/Blogs HTTP/1.1  
Content-Type: application/json  
Accept: application/json;odata=minimalmetadata  
Prefer: return-no-content  
DataServiceVersion: 3.0;  
  
{"PartitionKey":"Channel_17", "RowKey":"2", "Rating":9, "Text":"Azure..."}  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
MERGE https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_17', RowKey='3') HTTP/1.1  
Content-Type: application/json  
Accept: application/json;odata=minimalmetadata  
DataServiceVersion: 3.0;  
  
{"PartitionKey":"Channel_19", "RowKey":"3", "Rating":9, "Text":"PDC 2008..."}  
  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977--  
--batch_a1e9d677-b28b-435e-a89e-87e6a768a431

Atom フィード (2015-12-11 より前のバージョン)

次の例は、Atom ペイロードを含むバッチ要求を示しています。

POST /$batch HTTP/1.1  
User-Agent: Microsoft ADO.NET Data Services  
x-ms-version: 2013-08-15  
x-ms-date: Thu, 30 Aug 2013 20:45:13 GMT  
Authorization: SharedKeyLite myaccount:asOEzsCDS7YEe6oi+bx47KMwbXL0lYZCOlR/oc3FReQ=  
Accept: application/atom+xml,application/xml  
Accept-Charset: UTF-8  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  
Content-Type: multipart/mixed; boundary=batch_a1e9d677-b28b-435e-a89e-87e6a768a431  
Host: MyHostName:10002  
Prefer: return-no-content  
Content-Length: ###  
  
--batch_a1e9d677-b28b-435e-a89e-87e6a768a431  
Content-Type: multipart/mixed; boundary=changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
POST https://myaccount.table.core.windows.net/Blogs HTTP/1.1  
Content-ID: 1  
Content-Type: application/atom+xml;type=entry  
Content-Length: ###  
  
<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="https://www.w3.org/2005/Atom">  
  <title />  
  <author>  
    <name />  
  </author>  
  <id />  
  <content type="application/xml">  
    <m:properties>  
      <d:PartitionKey>Channel_19</d:PartitionKey>  
      <d:RowKey>1</d:RowKey>  
      <d:Rating m:type="Edm.Int32">9</d:Rating>  
      <d:Text>.NET...</d:Title>  
    </m:properties>  
  </content>  
</entry>  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
POST https://myaccount.table.core.windows.net/Blogs HTTP/1.1  
Content-ID: 2  
Content-Type: application/atom+xml;type=entry  
Prefer: return-no-content  
Content-Length: ###  
  
<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="https://www.w3.org/2005/Atom">  
  <title />  
  <author>  
    <name />  
  </author>  
  <id />  
  <content type="application/xml">  
    <m:properties>  
      <d:PartitionKey>Channel_19</d:PartitionKey>  
      <d:RowKey>2</d:RowKey>  
      <d:Rating m:type="Edm.Int32">9</d:Rating>  
      <d:Text>Azure...</d:Title>  
    </m:properties>  
  </content>  
</entry>  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
MERGE https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19', RowKey='3') HTTP/1.1  
Content-ID: 3  
Content-Type: application/atom+xml;type=entry  
Content-Length: ###  
  
<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="https://www.w3.org/2005/Atom">  
  <title />  
  <author>  
    <name />  
  </author>  
  <id>https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19',RowKey='3')</id>  
  
  <content type="application/xml">  
    <m:properties>  
      <d:PartitionKey>Channel_19</d:PartitionKey>  
      <d:RowKey>3</d:RowKey>  
      <d:Rating m:type="Edm.Int32">9</d:Rating>  
      <d:Text>PDC 2008...</d:Title>  
    </m:properties>  
  </content>  
</entry>  
--changeset_8a28b620-b4bb-458c-a177-0959fb14c977--  
--batch_a1e9d677-b28b-435e-a89e-87e6a768a431—

クエリの要求の例

次の例は、クエリのバッチ要求を示しています。変更セットにはクエリを 1 つしか含めることができないことに注意してください。

注意

JSON は推奨されるペイロード形式であり、バージョン 2015-12-11 以降でサポートされている唯一の形式です。

JSON (バージョン 2013-08-15 以降)

次の例は、JSON ペイロードを含むバッチ要求を示しています。

POST https://myaccount.table.core.windows.net/$batch HTTP/1.1  
x-ms-version: 2013-08-15  
Accept-Charset: UTF-8  
DataServiceVersion: 3.0;  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: multipart/mixed; boundary=batch_f351702c-c8c8-48c6-af2c-91b809c651ce  
x-ms-date: Mon, 14 Oct 2013 19:03:55 GMT  
Authorization: SharedKey testaccount1:y6TxCsXeRiR4l1KqihwRJ05Qb5zBk=  
Host: 127.0.0.1:10002  
Content-Length: 255  
Connection: Keep-Alive  
  
--batch_f351702c-c8c8-48c6-af2c-91b809c651ce  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
GET https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19',RowKey='2') HTTP/1.1  
Accept: application/json;odata=minimalmetadata  
  
--batch_f351702c-c8c8-48c6-af2c-91b809c651ce

Atom フィード (2015-12-11 より前のバージョン)

次の例は、Atom ペイロードを含むバッチ要求を示しています。

POST /$batch HTTP/1.1  
User-Agent: Microsoft ADO.NET Data Services  
x-ms-version: 2013-08-15  
x-ms-date: Thu, 30 Aug 2013 20:45:13 GMT  
Authorization: SharedKeyLite myaccount:asOEzsCDS7YEe6oi+bx47KMwbXL0lYZCOlR/oc3FReQ=  
Accept: application/atom+xml,application/xml  
Accept-Charset: UTF-8  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: multipart/mixed; boundary=batch_f351702c-c8c8-48c6-af2c-91b809c651ce  
Content-Length: ###  
  
--batch_f351702c-c8c8-48c6-af2c-91b809c651ce  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
GET https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19',RowKey='2') HTTP/1.1  
  
--batch_f351702c-c8c8-48c6-af2c-91b809c651ce—

バッチ応答の構文

応答では、バッチ要求の全体的なステータスコードと、変更セットに含まれる各操作の個別のステータスコードと結果のフラグメントが返されます。応答は、バッチ境界と変更セット境界が含まれるマルチパート MIME メッセージです。

テーブルサービスは、バッチ要求全体のステータスコードと、変更セットに含まれる操作の 1 つ以上のステータスコード (操作が成功したか失敗したかによって異なります) を返します。

バッチ要求が適切に承認され、Table サービスによって正常に受信されたと仮定すると、変更セット内のいずれかの操作が失敗した場合でも、バッチ要求は状態コード 202 (Accepted) を返します。バッチ要求自体が失敗する場合は、変更セットに含まれる操作の実行前に失敗します。たとえば、承認エラーが原因でバッチ要求が失敗する場合があります。その場合、状態コードはそのエラーを示します。

変更セット内の操作はアトミックに処理されます。つまり、バッチ内のすべての操作が成功するか、バッチ全体が失敗します。テーブルサービスは、操作が失敗するまで変更セット内の操作の処理を継続します。操作が失敗した場合、バッチ内のそれ以前の操作はすべてロールバックされます。また、エンティティグループトランザクションはスナップショット分離を使用して実行されます。

変更セットに含まれる個々の操作のステータスコードは、変更セットの応答に表示されます。個々の操作が失敗した場合、変更セットの応答にステータスコード 400 (Bad Request) が示されます。応答に含まれる追加のエラー情報では、失敗した操作が、その操作のインデックスを返すことによって示されます。インデックスはペイロード内のコマンドのシーケンス番号です。

たとえば、次のエラー応答の例を参照してください。

挿入、更新、および削除操作の応答の例

次の例は、前に示した要求例で送信されたバッチ操作の応答を示しています。

JSON (バージョン 2013-08-15 以降)

次の例は、JSON ペイロードを使用して行われた要求に対する応答を示しています。

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Content-Type: multipart/mixed; boundary=batchresponse_e69b1c6c-62ff-471e-ab88-9a4aeef0a880  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: ed9c96eb-9473-4fd9-abf6-fa4dcf0d6295  
x-ms-version: 2013-08-15  
X-Content-Type-Options: nosniff  
Date: Mon, 14 Oct 2013 18:25:49 GMT  
Content-Length: 1647  
  
--batchresponse_e69b1c6c-62ff-471e-ab88-9a4aeef0a880  
Content-Type: multipart/mixed; boundary=changesetresponse_a6253244-7e21-42a8-a149-479ee9e94a25  
  
--changesetresponse_a6253244-7e21-42a8-a149-479ee9e94a25  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 204 No Content  
Content-ID: 1  
X-Content-Type-Options: nosniff  
Cache-Control: no-cache  
Preference-Applied: return-no-content  
DataServiceVersion: 3.0;  
Location: https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19',RowKey='1')  
DataServiceId: https://myaccount.table.core.windows.net/Blogs (PartitionKey='Channel_19',RowKey='1')  
ETag: W/"0x8D101F7E4B662C4"  
  
--changesetresponse_a6253244-7e21-42a8-a149-479ee9e94a25  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 204 No Content  
Content-ID: 2  
X-Content-Type-Options: nosniff  
Cache-Control: no-cache  
Preference-Applied: return-no-content  
DataServiceVersion: 3.0;  
Location: https://myaccount.table.core.windows.net/Blogs (PartitionKey='Channel_19',RowKey='2')  
DataServiceId: https://myaccount.table.core.windows.net/Blogs (PartitionKey='Channel_19',RowKey='2')  
ETag: W/"0x8C134F7A4B692D8"  
  
--changesetresponse_a6253244-7e21-42a8-a149-479ee9e94a25  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 204 No Content  
Content-ID: 3  
X-Content-Type-Options: nosniff  
Cache-Control: no-cache  
DataServiceVersion: 1.0;  
ETag: W/"0x8A541B7C4D699D7"  
  
--changesetresponse_a6253244-7e21-42a8-a149-479ee9e94a25--  
--batchresponse_e69b1c6c-62ff-471e-ab88-9a4aeef0a880--

Atom フィード (2015-12-11 より前のバージョン)

次の例は、Atom ペイロードを使用して行われた要求に対する応答を示しています。

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Transfer-Encoding: chunked  
Content-Type: multipart/mixed; boundary=batchresponse_dc0fea8c-ed83-4aa8-ac9b-bf56a2d46dfb  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: b4b49b3e-19a9-4091-a280-da76a09da8d4  
Date: Thu, 30 Aug 2013 20:44:09 GMT  
  
334  
batchresponse_dc0fea8c-ed83-4aa8-ac9b-bf56a2d46dfb   
Content-Type: multipart/mixed; boundary=--changesetresponse_8a28b620-b4bb-458c-a177-0959fb14c977  
  
--changesetresponse_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 204 No Content  
Content-ID: 1  
Cache-Control: no-cache  
Preference-Applied: return-no-content  
ETag: W/"0x8D101F7E4B662C4"  
Location: https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19',RowKey='1')  
DataServiceVersion: 3.0;  
  
--changesetresponse_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 204 No Content  
Content-ID: 2  
Cache-Control: no-cache  
Preference-Applied: return-no-content  
ETag: W/"0x8C134F7A4B692D8"  
Location: https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19',RowKey='2')  
DataServiceVersion: 3.0;  
  
--changesetresponse_8a28b620-b4bb-458c-a177-0959fb14c977  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 204 No Content  
Content-ID: 3  
Cache-Control: no-cache  
ETag: W/"0x8A541B7C4D699D7"  
DataServiceVersion: 3.0;  
  
--changesetresponse_8a28b620-b4bb-458c-a177-0959fb14c977--  
--batchresponse_4c637ba4-b2f8-40f8-8856-c2d10d163a83--

クエリの応答の例

次の例は、前に示した要求例で送信されたクエリの応答を示しています。

JSON (バージョン 2013-08-15 以降)

次の例は、JSON ペイロードを使用して行われた要求に対する応答を示しています。

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Content-Type: multipart/mixed; boundary=batchresponse_0a568496-fb38-4a83-9984-5908d7f4c63d  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: 6f2aafa3-19e9-434c-85f2-d178941c2d4b  
x-ms-version: 2013-08-15  
X-Content-Type-Options: nosniff  
Date: Mon, 14 Oct 2013 19:13:30 GMT  
Content-Length: 615  
  
--batchresponse_0a568496-fb38-4a83-9984-5908d7f4c63d  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 200 OK  
DataServiceVersion: 3.0;  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
X-Content-Type-Options: nosniff  
Cache-Control: no-cache  
ETag: W/"0x5B168C7B6E589D2"  
  
{"odata.metadata":" https://myaccount.table.core.windows.net/Blogs/$metadata#Blogs/@Element","PartitionKey":"Channel_19","RowKey":"2","Timestamp":"2013-10-14T18:25:49.8922467Z","Rating":9,"Text":"Azure..."}  
--batchresponse_0a568496-fb38-4a83-9984-5908d7f4c63d--

Atom フィード (2015-12-11 より前のバージョン)

次の例は、Atom ペイロードを使用して行われた要求に対する応答を示しています。

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Transfer-Encoding: chunked  
Content-Type: multipart/mixed; boundary=batchresponse_4c637ba4-b2f8-40f8-8856-c2d10d163a83  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: 9202c4a1-43af-4dc0-baca-aa71f7a7407b  
Date: Thu, 30 Aug 2013 20:44:10 GMT  
  
--batchresponse_4c637ba4-b2f8-40f8-8856-c2d10d163a83  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 200 OK  
Content-Type: application/atom+xml;charset=utf-8  
Cache-Control: no-cache  
ETag: W/"0x5B168C7B6E589D2"  
DataServiceVersion: 3.0;  
  
<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xml:base="http://127.0.0.1:10002/testaccount1/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" m:etag="W/"0x5B168C7B6E589D2"" xmlns="https://www.w3.org/2005/Atom">  
    <id> https://myaccount.table.core.windows.net/Blogs(PartitionKey='Channel_19',RowKey='1')</id>  
  <title type="text"></title>  
  <updated>2013-08-30T20:44:10Z</updated>  
  <author>  
    <name />  
  </author>  
  <link rel="edit" title="Blogs" href=" Blogs(PartitionKey='Channel_19',RowKey='2')" />  
  <category term="myaccount.Blogs" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
  <content type="application/xml">  
    <m:properties>  
      <d:PartitionKey>Channel_19</d:PartitionKey>  
       <d:RowKey>2</d:RowKey>  
       <d:Timestamp m:type="Edm.DateTime">2013-08-30T20:44:09.5789464Z</d:Timestamp>  
       <d:Text>.Net...</d:RowKey>  
      <d:Rating m:type="Edm.Int32">9</d:Rating>  
    </m:properties>  
  </content>  
</entry>  
--batchresponse_4c637ba4-b2f8-40f8-8856-c2d10d163a83--

エラー応答の例

次の例は、失敗した 1 つの操作を含むバッチ要求からの応答を示しています。バッチ応答ではステータスコード 202 (Accepted) が返されていますが、失敗した個別の操作ではステータスコード 400 (Bad Request) が返されていることに注意してください。追加のエラー情報は、失敗した操作の応答本文に含まれています。 code 要素はストレージサービスのエラーコードを示します。一方、message 要素は失敗した操作のインデックスで始まり、その後にエラーメッセージ文字列が表示されます。どの操作が失敗したかを調べるには、メッセージのインデックス値を解析します。操作にはゼロから順にインデックスが付けられています。

JSON 形式の要求に対するエラー応答

JSON の例では、失敗した操作は変更セット内の 1 番目の操作です。 message の名前と値のペア内で、メッセージが数字 0 で始まり、その後に追加のエラー情報が表示されています。

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Content-Type: multipart/mixed; boundary=batchresponse_4e1c04af-af2b-4cfc-9e35-7677a5efcfca  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: 8abd3c55-a72e-47ba-ae0b-ba43abeb76ae  
x-ms-version: 2013-08-15  
X-Content-Type-Options: nosniff  
Date: Mon, 14 Oct 2013 19:21:58 GMT  
Content-Length: 1051  
  
--batchresponse_4e1c04af-af2b-4cfc-9e35-7677a5efcfca  
Content-Type: multipart/mixed; boundary=changesetresponse_e2a26601-bba8-4c1a-8a8c-bb66badcbca1  
  
--changesetresponse_e2a26601-bba8-4c1a-8a8c-bb66badcbca1  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 400 Bad Request  
Content-ID: 1  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
  
{"odata.error":{"code":"OutOfRangeInput","message":{"lang":"en-US","value":"0:One of the request inputs is out of range.\nRequestId:8abd3c55-a72e-47ba-ae0b-ba43abeb76ae\nTime:2013-10-14T19:21:58.0890048Z}}}  
--changesetresponse_e2a26601-bba8-4c1a-8a8c-bb66badcbca1--  
--batchresponse_4e1c04af-af2b-4cfc-9e35-7677a5efcfca--

Atom 形式の要求に対するエラー応答

Atom の例では、失敗した操作は変更セット内の 4 番目の操作です。 message 要素内で、メッセージが数字 3 で始まり、その後に追加のエラー情報が表示されています。

<message xml:lang="en-US">3:One of the request inputs is not valid.</message>

応答の全体を次に示します。

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Transfer-Encoding: chunked  
Content-Type: multipart/mixed; boundary=batchresponse_7ab1553a-7dd6-44e7-8107-bf1ea1ab1876  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: 45ac953e-a4a5-42ba-9b4d-97bf74a8a32e  
Date: Thu, 30 Apr 2009 20:45:13 GMT  
  
6E7  
--batchresponse_7ab1553a-7dd6-44e7-8107-bf1ea1ab1876  
Content-Type: multipart/mixed; boundary=changesetresponse_6cc856b4-8cb9-41eb-b8d2-bb73475c6cec  
  
--changesetresponse_6cc856b4-8cb9-41eb-b8d2-bb73475c6cec  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 400 Bad Request  
Content-ID: 4  
Content-Type: application/xml  
Cache-Control: no-cache  
DataServiceVersion: 1.0;  
  
<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">  
  <code>InvalidInput</code>  
  <message xml:lang="en-US">3:One of the request inputs is not valid.</message>  
</error>  
--changesetresponse_6cc856b4-8cb9-41eb-b8d2-bb73475c6cec--  
--batchresponse_7ab1553a-7dd6-44e7-8107-bf1ea1ab1876--

参照

OData 仕様
 テーブルサービスの概念

エンティティ グループ トランザクションの実行

エンティティ グループ トランザクションの要件

テーブル サービスでの OData バッチ要求のサポート

REST を使用したエンティティ グループ トランザクション

バッチ要求の構文

挿入、更新、および削除操作の要求の例

JSON (バージョン 2013-08-15 以降)

Atom フィード (2015-12-11 より前のバージョン)

クエリの要求の例

JSON (バージョン 2013-08-15 以降)

Atom フィード (2015-12-11 より前のバージョン)

バッチ応答の構文

挿入、更新、および削除操作の応答の例

JSON (バージョン 2013-08-15 以降)

Atom フィード (2015-12-11 より前のバージョン)

クエリの応答の例

JSON (バージョン 2013-08-15 以降)

Atom フィード (2015-12-11 より前のバージョン)

エラー応答の例

JSON 形式の要求に対するエラー応答

Atom 形式の要求に対するエラー応答

参照

その他のリソース

エンティティグループトランザクションの実行

エンティティグループトランザクションの要件

テーブルサービスでの OData バッチ要求のサポート

REST を使用したエンティティグループトランザクション