Entiteiten invoegen en bijwerken

Als u een entiteit wilt invoegen of bijwerken, voegt u bij de aanvraag een OData ATOM- of OData JSON-entiteit toe die de eigenschappen en gegevens voor de entiteit specificeert. Zie Nettolading-indeling voor Tabelservicebewerkingen voor meer informatie over de indeling van de nettolading.

Met de bewerking Entiteit invoegen voegt u een nieuwe entiteit in met een unieke primaire sleutel, gevormd op basis van de combinatie van de PartitionKey en de RowKey. De bewerking Entiteit bijwerken vervangt een bestaande entiteit door dezelfde en PartitionKey RowKey . Met de bewerking Entiteit samenvoegen worden de eigenschappen van een bestaande entiteit bijgewerkt, maar wordt de entiteit niet vervangen. Met de bewerking Entiteit invoegen of samenvoegen wordt een nieuwe entiteit gemaakt 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 wordt een nieuwe entiteit gemaakt met een unieke primaire sleutel of wordt een bestaande entiteit vervangen.

De atomfeed maken

De Atom-feed voor een invoeg- of bijvoegbewerking 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 in het element zijn m:properties opgegeven. Het type van de eigenschap wordt opgegeven door het m:type kenmerk . Zie Nettolading-indeling voor Tabelservicebewerkingen voor gedetailleerde informatie over eigenschapstypen.

Hier is 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 vóór 12-01-2015. Vanaf versie 2015-12-11 moeten nettoladingen in JSON zijn.

De JSON-feed maken

Als u een entiteit wilt invoegen of bijwerken met behulp van de JSON-indeling OData, maakt u een JSON-object met eigenschapsnamen als sleutels samen met de eigenschapswaarden. Mogelijk moet u het eigenschapstype opnemen als dit niet kan worden afgeleid via de heuristiek van OData JSON-typedetectie. Zie Payload Format for Table Service Operations (Nettoladingnotatie voor Table Service-bewerkingen) voor informatie over de heuristiek van eigenschapstypedetectie en over het gebruik van JSON OData.

De JSON-nettolading die overeenkomt met het bovenstaande 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"  
}  
  

Zie ook

Concepten van Table Service
Bewerkingen op entiteiten