Inserire e aggiornare le entità

  • Articolo

Per inserire o aggiornare un'entità, includere con la richiesta un'entità OData ATOM o OData JSON che specifica le proprietà e i dati per l'entità. Per altre informazioni sul formato del payload, vedere Formato del payload per le operazioni di archiviazione tabelle di Azure.

L'operazione Inserisci entità inserisce una nuova entità con una chiave primaria univoca, formata dalla combinazione della chiave di partizione e della chiave di riga. L'operazione Aggiorna entità sostituisce un'entità esistente con la stessa PartitionKey e RowKey. L'operazione Merge Entity aggiorna le proprietà di un'entità esistente, ma non sostituisce l'entità.

L'operazione Inserisci o merge entità crea una nuova entità con una chiave primaria univoca o aggiorna le proprietà di un'entità esistente, ma non sostituisce l'entità. L'operazione Inserisci o sostituisci entità crea una nuova entità con una chiave primaria univoca o sostituisce un'entità esistente.

Costruire il feed Atom

Il feed Atom per un'operazione di inserimento o aggiornamento definisce le proprietà dell'entità specificando nomi e tipi di dati e imposta i valori di tali proprietà.

L'elemento content contiene le definizioni delle proprietà dell'entità, specificate nell'elemento m:properties. Il tipo di proprietà è specificato dall'attributo m:type. Per informazioni dettagliate sui tipi di proprietà, vedere Formato del payload per le operazioni di archiviazione tabelle.

Ecco un esempio di feed Atom per un'operazione Inserisci entità :

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

Nota

I payload Atom sono supportati solo nelle versioni precedenti alla versione 2015-12-11. A partire dalla versione 2015-12-11, i payload devono essere in JSON.

Costruire il feed JSON

Per inserire o aggiornare un'entità usando il OData formato JSON, creare un oggetto JSON con nomi di proprietà come chiavi, insieme ai relativi valori di proprietà. Potrebbe essere necessario includere il tipo di proprietà se non può essere dedotto tramite OData l'euristica del rilevamento dei tipi JSON.

Il payload JSON corrispondente all'esempio Atom precedente è il seguente:

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

Vedi anche

Concetti relativi all'archiviazione tabelle
Operazioni sulle entità