엔터티 삽입 및 업데이트
엔터티를 삽입하거나 업데이트하려면 엔터티의 속성과 데이터를 지정하는 ATOM 또는 OData
JSON 엔터티 요청에 OData
를 포함합니다. 페이로드 형식에 대한 자세한 내용은 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"
}