Entitások beszúrása és frissítése
Egy entitás beszúrásához vagy frissítéséhez a kéréshez OData egy ATOM- vagy OData JSON-entitást kell megadnia, amely meghatározza az entitás tulajdonságait és adatait. A hasznos adatok formátumáról további információt az Azure Table Storage-műveletek hasznos adatformátuma című témakörben talál.
Az Entitás beszúrása művelet egy új entitást szúr be egy egyedi elsődleges kulccsal, amely a partíciókulcs és a sorkulcs kombinációjából jön létre. Az Update Entity (Entitás frissítése) művelet egy meglévő entitást cserél le ugyanazzal PartitionKey a és RowKey. Az Entitás egyesítése művelet frissíti egy meglévő entitás tulajdonságait, de nem helyettesíti az entitást.
Az Entitás beszúrása vagy egyesítése művelet létrehoz egy új entitást egy egyedi elsődleges kulccsal, vagy frissíti egy meglévő entitás tulajdonságait, de nem helyettesíti az entitást. Az Entitás beszúrása vagy cseréje művelet létrehoz egy új entitást egy egyedi elsődleges kulccsal, vagy lecserél egy meglévő entitást.
Az Atom-hírcsatorna létrehozása
A beszúrási vagy frissítési művelet Atom-hírcsatornája a nevük és az adattípusuk megadásával határozza meg az entitás tulajdonságait, és beállítja ezeknek a tulajdonságoknak az értékeit.
Az content elem tartalmazza az entitás tulajdonságdefinícióit, amelyek az m:properties elemen belül vannak megadva. A tulajdonság típusát az m:type attribútum határozza meg. A tulajdonságtípusokról további információt a Table Storage-műveletek hasznos adatformátuma című témakörben talál.
Íme egy példa az Entitás beszúrása művelet Atom-hírcsatornájára:
<?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>
Megjegyzés
Az atom hasznos adatok csak a 2015-12-11 előtti verziókban támogatottak. A 2015-12-11-es verziótól kezdődően a hasznos adatoknak JSON-ban kell lenniük.
A JSON-hírcsatorna létrehozása
Ha JSON-formátummal OData szeretne beszúrni vagy frissíteni egy entitást, hozzon létre egy JSON-objektumot, amely tulajdonságneveket tartalmaz kulcsként, a tulajdonságértékekkel együtt. Előfordulhat, hogy fel kell vennie a tulajdonságtípust, ha nem lehet JSON-típusészlelési heurisztikusokkal következtetni OData rá.
Az előző Atom-példának megfelelő JSON hasznos adat a következő:
{
"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"
}