Infoga och uppdatera entiteter

Om du vill infoga eller uppdatera en entitet inkluderar du med begäran en ATOM- eller OData JSON-entitet OData som anger egenskaperna och data för entiteten. Mer information om nyttolastens format finns i Nyttolastformat för Azure Table Storage-åtgärder.

Åtgärden Infoga entitet infogar en ny entitet med en unik primärnyckel som bildas från kombinationen av partitionsnyckeln och radnyckeln. Åtgärden Uppdatera entitet ersätter en befintlig entitet med samma PartitionKey och RowKey. Åtgärden Sammanfoga entitet uppdaterar egenskaperna för en befintlig entitet, men ersätter inte entiteten.

Åtgärden Infoga eller sammanfoga entitet skapar en ny entitet med en unik primärnyckel eller uppdaterar egenskaperna för en befintlig entitet, men ersätter inte entiteten. Åtgärden Infoga eller ersätt entitet skapar en ny entitet med en unik primärnyckel eller ersätter en befintlig entitet.

Konstruera Atom-feeden

Atom-feeden för en infognings- eller uppdateringsåtgärd definierar entitetens egenskaper genom att ange deras namn och datatyper och anger värdena för dessa egenskaper.

Elementet content innehåller entitetens egenskapsdefinitioner, som anges i -elementet m:properties . Egenskapens typ anges av attributet m:type . Detaljerad information om egenskapstyper finns i Nyttolastformat för Table Storage-åtgärder.

Här är ett exempel på en Atom-feed för en insert-entitetsåtgärd :

<?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>  

Anteckning

Atomnyttolaster stöds endast i versioner före 2015-12-11. Från och med version 2015-12-11 måste nyttolaster finnas i JSON.

Konstruera JSON-feeden

Om du vill infoga eller uppdatera en entitet med hjälp OData av JSON-formatet skapar du ett JSON-objekt med egenskapsnamn som nycklar, tillsammans med deras egenskapsvärden. Du kan behöva inkludera egenskapstypen om den inte kan härledas via OData heuristik för JSON-typidentifiering.

JSON-nyttolasten som motsvarar föregående Atom-exempel är följande:

{  
   "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"  
}  
  

Se även

Begrepp för Table Storage
Åtgärder på entiteter