エンティティの挿入と更新

エンティティを挿入または更新するには、エンティティのプロパティとデータを OData 指定する ATOM または OData JSON エンティティを要求に含めます。 ペイロードの形式の詳細については、「 Azure Table Storage 操作のペイロード形式」を参照してください。

エンティティの挿入操作は、パーティション キーと行キーの組み合わせから形成された一意の主キーを持つ新しいエンティティを挿入します。 エンティティの更新操作は、既存のエンティティを 同じ PartitionKey と RowKeyに置き換えます。 エンティティのマージ操作では、既存のエンティティのプロパティが更新されますが、エンティティは置き換えられません。

エンティティの挿入またはマージ操作では、一意の主キーを持つ新しいエンティティが作成されるか、既存のエンティティのプロパティが更新されますが、エンティティは置き換えられません。 エンティティの挿入または置換操作では、一意の主キーを持つ新しいエンティティを作成するか、既存のエンティティを置き換えます。

Atom フィードを構築する

挿入または更新操作用の Atom フィードは、名前とデータ型を指定することでエンティティのプロパティを定義し、これらのプロパティの値を設定します。

content 要素にはエンティティのプロパティ定義が格納され、それらは m:properties 要素内に定義されます。 プロパティの型は m:type 属性によって指定されます。 プロパティの種類の詳細については、「 Table Storage 操作のペイロード形式」を参照してください。

エンティティの挿入操作の Atom フィードの例を次に示します。

<?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:Address>Mountain View</d:Address>  
      <d:Age m:type="Edm.Int32">23</d:Age>  
      <d:AmountDue m:type="Edm.Double">200.23</d:AmountDue>  
      <d:BinaryData m:type="Edm.Binary" m:null="true" />  
      <d:CustomerCode m:type="Edm.Guid">c9da6455-213d-42c9-9a79-3e9149a57833</d:CustomerCode>  
      <d:CustomerSince m:type="Edm.DateTime">2008-07-10T00:00:00</d:CustomerSince>  
      <d:IsActive m:type="Edm.Boolean">true</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>  

JSON フィードを構築する

JSON 形式を使用 OData してエンティティを挿入または更新するには、プロパティ名をキーとして持つ JSON オブジェクトを、プロパティ値と共に作成します。 JSON 型検出ヒューリスティックを使用して OData 推論できない場合は、プロパティ型を含める必要がある場合があります。

上記の Atom の例に対応する JSON ペイロードは次のとおりです。

{  
   "Address":"Mountain View",  
   "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":true,  
   "NumOfOrders@odata.type":"Edm.Int64",  
   "NumOfOrders":"255",  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey"  
}  
  

関連項目

Table Storage の概念
エンティティに対する操作