Entiteiten invoegen en bijwerken
Als u een entiteit wilt invoegen of bijwerken, neemt u bij de aanvraag een OData ATOM- of OData JSON-entiteit op die de eigenschappen en gegevens voor de entiteit opgeeft. Zie Payload-indeling voor Azure Table Storage-bewerkingen voor meer informatie over de indeling van de nettolading.
Met de bewerking Entiteit invoegen wordt een nieuwe entiteit met een unieke primaire sleutel ingevoegd, die is samengesteld uit de combinatie van de partitiesleutel en de rijsleutel. De bewerking Entiteit bijwerken vervangt een bestaande entiteit door dezelfde PartitionKey en RowKey. De bewerking Entiteit samenvoegen werkt de eigenschappen van een bestaande entiteit bij, maar vervangt de entiteit niet.
Met de bewerking Entiteit invoegen of samenvoegen maakt u een nieuwe entiteit met een unieke primaire sleutel of worden de eigenschappen van een bestaande entiteit bijgewerkt, maar wordt de entiteit niet vervangen. Met de bewerking Entiteit invoegen of vervangen maakt u een nieuwe entiteit met een unieke primaire sleutel of vervangt u een bestaande entiteit.
De Atom-feed samenstellen
De Atom-feed voor een invoeg- of updatebewerking definieert de eigenschappen van de entiteit door de namen en gegevenstypen op te geven, en stelt de waarden voor deze eigenschappen in.
Het content -element bevat de eigenschapsdefinities van de entiteit, die zijn opgegeven in het m:properties -element. Het type van de eigenschap wordt opgegeven door het m:type kenmerk. Zie Payload-indeling voor Table Storage-bewerkingen voor gedetailleerde informatie over eigenschapstypen.
Hier volgt een voorbeeld van een Atom-feed voor een bewerking Entiteit invoegen :
<?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>
Notitie
Atom-nettoladingen worden alleen ondersteund in versies ouder dan 2015-12-11. Vanaf versie 2015-12-11 moeten payloads zich in JSON bevinden.
De JSON-feed samenstellen
Als u een entiteit wilt invoegen of bijwerken met behulp van de OData JSON-indeling, maakt u een JSON-object met eigenschapsnamen als sleutels, samen met de bijbehorende eigenschapswaarden. Mogelijk moet u het eigenschapstype opnemen als dit niet kan worden afgeleid via OData de heuristiek van JSON-typedetectie.
De JSON-nettolading die overeenkomt met het voorgaande Atom-voorbeeld is als volgt:
{
"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"
}