Insert Or Replace Entity

この操作は Insert Or Replace Entity 、既存のエンティティを置き換えるか、テーブルに存在しない場合は新しいエンティティを挿入します。 この操作はエンティティを挿入または更新できるため、 アップサート 操作とも呼ばれます。

要求

要求は Insert Or Replace Entity 次のように構築できます。 HTTPS が推奨されます。 次の値は固有の値に置き換えてください。

• myaccount は使用するストレージ アカウントの名前で置き換えます。

• mytable は使用するテーブルの名前で置き換えます。

• myPartitionKey および myRowKey を更新するエンティティのパーティション キーと行キーの名前を指定します。

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

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

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

URI パラメーター

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

要求ヘッダー

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

要求本文

この操作により Insert Or Replace Entity 、エンティティ セットとして挿入されるエンティティが OData 送信されます。 このエンティティ セットには、JSON または Atom フィードを指定できます。 詳細については、「 エンティティの挿入と更新」を参照してください。

Response

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

status code

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

応答ヘッダー

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

応答本文

[なし] :

承認

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

要求と応答の例

次の例は、JSON フィードと Atom フィードを使用するサンプル要求を示しています。

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

JSON を使用する要求と応答の例を次に示します。

PUT https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey',RowKey='myRowKey')  

要求は次のヘッダーと共に送信されます。

x-ms-version: 2013-08-15  
Content-Type: application/json  
x-ms-date: Tue, 30 Aug 2013 18:10:24 GMT  
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=  
Content-Length: 1135  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  

要求は次の JSON 本文と共に送信されます。

{  
   "Address":"Santa Clara",  
   "Age":23,  
   "AmountDue":200.23,  
   "CustomerCode@odata.type":"Edm.Guid",  
   "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
   "CustomerSince@odata.type":"Edm.DateTime",  
   "CustomerSince":"2008-07-10T00:00:00",  
   "IsActive":false,  
   "NumberOfOrders@odata.type":"Edm.Int64",  
   "NumberOfOrders":"255",  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey"  
}  

要求が送信された後、次の応答が返されます。

HTTP/1.1 204 No Content  
  
Connection: Keep-Alive  
x-ms-request-id: 2c085f8f-11a4-4e1d-bd49-82c6bd87649d  
Content-Length: 0  
Cache-Control: no-cache  
Date: Tue, 30 Aug 2013 18:12:54 GMT  
ETag: W/"0x5B168C7B6E589D2"  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  

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

Atom を使用する要求と応答の例を次に示します。

PUT https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey',RowKey='myRowKey')  

要求は次のヘッダーと共に送信されます。

x-ms-version: 2013-08-15  
Accept: application/atom+xml,application/xml  
Accept-Charset: UTF-8  
Content-Type: application/atom+xml  
x-ms-date: Tue, 12 Nov 2013 18:10:24 GMT  
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=  
Content-Length: 1135  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  

要求は次の XML 本文と共に送信されます。

<?xml version="1.0" encoding="utf-8"?>  
<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 />  
  <updated>2013-11-12T18:09:37.168836Z</updated>  
  <author>  
    <name />  
  </author>  
<id>https://myaccount.table.core.windows.net/mytable(PartitionKey='mypartitionkey',RowKey='myrowkey1')</id>  
  <content type="application/xml">  
    <m:properties>  
      <d:Address>Santa Clara</d:Address>  
      <d:Age m:type="Edm.Int32">23</d:Age>  
      <d:AmountDue m:type="Edm.Double">200.23</d:AmountDue>  
      <d:CustomerCode m:type="Edm.Guid">c9da6455-213d-42c9-9a79-3e9149a57833</d:CustomerCode>  
      <d:CustomerSince m:type="Edm.DateTime">2008-07-10T00:00:00Z</d:CustomerSince>  
      <d:IsActive m:type="Edm.Boolean">false</d:IsActive>  
      <d:NumOfOrders m:type="Edm.Int64">255</d:NumOfOrders>  
      <d:PartitionKey>mypartitionkey</d:PartitionKey>  
      <d:RowKey>myrowkey1</d:RowKey>  
    </m:properties>  
  </content>  
</entry>  

要求が送信された後、次の応答が返されます。

HTTP/1.1 204 No Content  
  
Connection: Keep-Alive  
x-ms-request-id: 2c085f8f-11a4-4e1d-bd49-82c6bd87649d  
Content-Length: 0  
Cache-Control: no-cache  
Date: Tue, 12 Nov 2013 18:12:54 GMT  
ETag: W/"0x5B168C7B6E589D2"  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  

注釈

操作では Insert Or Replace Entity ヘッダーは If-Match 使用されません。 この操作は、2011-08-18 バージョン以降を使用して呼び出す必要があります。 これらの属性は、この操作と エンティティの更新 操作を区別します。

操作を Insert Or Replace Entity 使用してエンティティを置き換える場合、新しいエンティティで定義されていない場合は、前のエンティティのすべてのプロパティが削除されます。 値を null 持つプロパティも削除されます。

操作を呼び出すときはInsert or Replace Entity、 プロパティと RowKey システム プロパティの値を指定するPartitionKey必要があります。 これらのプロパティは共に主キーを形成し、テーブル内で一意である必要があります。

と RowKey の両方のPartitionKey値は文字列値である必要があります。 PartitionKey と RowKey の値のサイズは最大 1024 文字です。 キー値に整数値を使用している場合は、整数を固定幅の文字列に変換する必要があります。 これは、それらが正規に並べ替えられているためです。 たとえば、値 1 を に変換して 0000001、適切な並べ替えを行います。

プロパティを明示的に入力するには、Atom フィードのプロパティ定義内で 属性をm:type設定して、適切なODataデータ型を指定します。 プロパティの入力の詳細については、「 エンティティの挿入と更新」を参照してください。

要求を承認して送信できるアプリケーションは、エンティティを HTTP PUT 挿入または置換できます。

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

こちらもご覧ください

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