Varlık ekleme ve güncelleştirme
Varlık eklemek veya güncelleştirmek için isteğine varlığın özelliklerini ve verilerini belirten bir OData ATOM veya OData JSON varlığı eklersiniz. Yükün biçimi hakkında daha fazla bilgi için bkz. Azure Tablo Depolama işlemleri için yük biçimi.
Varlık Ekle işlemi, bölüm anahtarı ile satır anahtarının birleşiminden oluşturulmuş benzersiz bir birincil anahtara sahip yeni bir varlık ekler. Varlığı Güncelleştir işlemi, var olan bir varlığı aynı PartitionKey ve RowKeyile değiştirir. Varlığı Birleştir işlemi var olan bir varlığın özelliklerini güncelleştirir, ancak varlığın yerini almaz.
Varlık Ekle veya Birleştir işlemi benzersiz bir birincil anahtara sahip yeni bir varlık oluşturur ya da var olan bir varlığın özelliklerini güncelleştirir, ancak varlığın yerini almaz. Varlık Ekle veya Değiştir işlemi benzersiz bir birincil anahtarla yeni bir varlık oluşturur veya var olan bir varlığın yerini alır.
Atom akışını oluşturma
Ekleme veya güncelleştirme işlemi için Atom akışı, adlarını ve veri türlerini belirterek varlığın özelliklerini tanımlar ve bu özelliklerin değerlerini ayarlar.
content öğesi, varlığın öğesi içinde m:properties belirtilen özellik tanımlarını içerir. Özelliğin türü özniteliği tarafından m:type belirtilir. Özellik türleri hakkında ayrıntılı bilgi için bkz. Tablo Depolama işlemleri için Yük biçimi.
Burada, Varlık Ekleme işlemi için Atom akışı örneği verilmiştir:
<?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>
Not
Atom yükleri yalnızca 2015-12-11 öncesi sürümlerde desteklenir. 2015-12-11 sürümünden itibaren yüklerin JSON'da olması gerekir.
JSON akışını oluşturma
JSON biçimini kullanarak OData varlık eklemek veya güncelleştirmek için, özellik adları anahtar olarak ve özellik değerleriyle birlikte bir JSON nesnesi oluşturun. JSON türü algılama buluşsal yöntemleri aracılığıyla OData çıkarılamıyorsa özellik türünü eklemeniz gerekebilir.
Önceki Atom örneğine karşılık gelen JSON yükü aşağıdaki gibidir:
{
"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"
}