Menyisipkan dan memperbarui entitas
Untuk menyisipkan atau memperbarui entitas, Anda menyertakan dengan permintaan OData entitas ATOM atau OData JSON yang menentukan properti dan data untuk entitas. Untuk informasi selengkapnya tentang format payload, lihat Format payload untuk operasi Azure Table Storage.
Operasi Sisipkan Entitas menyisipkan entitas baru dengan kunci primer unik, yang dibentuk dari kombinasi kunci partisi dan kunci baris. Operasi Perbarui Entitas menggantikan entitas yang ada dengan dan RowKeyyang samaPartitionKey. Operasi Gabungkan Entitas memperbarui properti entitas yang ada, tetapi tidak menggantikan entitas.
Operasi Sisipkan Atau Gabungkan Entitas membuat entitas baru dengan kunci primer unik, atau memperbarui properti entitas yang ada, tetapi tidak menggantikan entitas. Operasi Sisipkan Atau Ganti Entitas membuat entitas baru dengan kunci primer unik, atau mengganti entitas yang ada.
Membangun umpan Atom
Umpan Atom untuk operasi sisipan atau pembaruan menentukan properti entitas dengan menentukan nama dan jenis data mereka, dan mengatur nilai untuk properti tersebut.
Elemen content berisi definisi properti entitas, yang ditentukan dalam m:properties elemen . Jenis properti ditentukan oleh m:type atribut . Untuk informasi mendetail tentang jenis properti, lihat Format payload untuk operasi Table Storage.
Berikut adalah contoh umpan Atom untuk operasi Sisipkan Entitas :
<?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>
Catatan
Payload atom hanya didukung dalam versi sebelum 2015-12-11. Dimulai dengan versi 2015-12-11, payload harus berada di JSON.
Membuat umpan JSON
Untuk menyisipkan atau memperbarui entitas dengan menggunakan OData format JSON, buat objek JSON dengan nama properti sebagai kunci, bersama dengan nilai propertinya. Anda mungkin perlu menyertakan jenis properti jika tidak dapat disimpulkan melalui OData heuristik deteksi jenis JSON.
Payload JSON yang sesuai dengan contoh Atom sebelumnya adalah sebagai berikut:
{
"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"
}