エンティティの挿入と更新
エンティティを挿入または更新するには、エンティティのプロパティとデータを 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>
注意
Atom ペイロードは、2015-12-11 より前のバージョンでのみサポートされています。 バージョン 2015-12-11 以降では、ペイロードは JSON に含まれる必要があります。
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"
}