Vložení a aktualizace entit
Pokud chcete vložit nebo aktualizovat entitu, zahrnete do požadavku entitu OData ATOM nebo OData JSON, která určuje vlastnosti a data entity. Další informace o formátu datové části najdete v tématu Formát datové části pro operace Azure Table Storage.
Operace Vložit entitu vloží novou entitu s jedinečným primárním klíčem vytvořeným z kombinace klíče oddílu a klíče řádku. Operace Update Entity nahradí existující entitu stejnou PartitionKey entitou a RowKey. Operace Sloučit entitu aktualizuje vlastnosti existující entity, ale nenahrazuje entitu.
Operace Vložit nebo sloučit entitu vytvoří novou entitu s jedinečným primárním klíčem nebo aktualizuje vlastnosti existující entity, ale nenahrazuje entitu. Operace Vložit nebo nahradit entitu vytvoří novou entitu s jedinečným primárním klíčem nebo nahradí existující entitu.
Vytvoření informačního kanálu Atom
Informační kanál Atom pro operaci vložení nebo aktualizace definuje vlastnosti entity zadáním jejich názvů a datových typů a nastaví hodnoty pro tyto vlastnosti.
Element content obsahuje definice vlastností entity, které jsou zadány v elementu m:properties . Typ vlastnosti je určen atributem m:type . Podrobné informace o typech vlastností najdete v tématu Formát datové části pro operace Table Storage.
Tady je příklad informačního kanálu Atom pro operaci Vložit entitu :
<?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>
Poznámka
Datové části Atom jsou podporovány pouze ve verzích starších než 2015-12-11. Počínaje verzí 2015-12-11 musí být datové části ve formátu JSON.
Vytvoření informačního kanálu JSON
Pokud chcete vložit nebo aktualizovat entitu OData pomocí formátu JSON, vytvořte objekt JSON s názvy vlastností jako klíči a jejich hodnotami vlastností. Pokud se nedá odvodit pomocí OData heuristiky detekce typů JSON, může být nutné zahrnout typ vlastnosti.
Datová část JSON odpovídající předchozímu příkladu Atom je následující:
{
"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"
}