Insert Or Replace Entity

L'operazione Insert Or Replace Entity sostituisce un'entità esistente o inserisce una nuova entità se non esiste nella tabella. Poiché questa operazione può inserire o aggiornare un'entità, è nota anche come operazione upsert .

Richiesta

È possibile costruire la Insert Or Replace Entity richiesta come indicato di seguito. È consigliato il protocollo HTTPS. Sostituire i valori seguenti con valori personalizzati:

• myaccount con l'account di archiviazione

• mytable con il nome della tabella

• myPartitionKey e myRowKey con il nome della chiave di partizione e della chiave di riga per l'entità da aggiornare

Servizio di archiviazione emulato

Quando si effettua una richiesta con il servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta di archiviazione tabelle di Azure come 127.0.0.1:10002, seguita dal nome dell'account di archiviazione emulato.

Archiviazione tabelle nell'emulatore di archiviazione differisce da Archiviazione tabelle di Azure in diversi modi. Per altre informazioni, vedere Differenze tra l'emulatore di archiviazione e i servizi di archiviazione di Azure.

Parametri URI

È possibile specificare il parametro aggiuntivo seguente nell'URI della richiesta.

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Testo della richiesta

L'operazione Insert Or Replace Entity invia l'entità da inserire come OData set di entità. Questo set di entità può essere un feed JSON o Atom. Per altre informazioni, vedere Inserimento e aggiornamento di entità.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codice stato

Un'operazione completata correttamente restituisce il codice di stato 204 (Nessun contenuto). Per informazioni sui codici di stato, vedere Codici di errore e stato e codici di errore di archiviazione tabelle.

Intestazioni di risposta

Nella risposta sono incluse le intestazioni seguenti. La risposta può includere anche intestazioni HTTP aggiuntive e standard. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Corpo della risposta

Nessuno.

Autorizzazione

Il proprietario dell'account può eseguire questa operazione. Inoltre, chiunque abbia l'autorizzazione per eseguire questa operazione può essere eseguita da chiunque con una firma di accesso condiviso.

Richiesta di esempio e risposta

Negli esempi seguenti vengono illustrate le richieste di esempio che usano feed JSON e Atom.

JSON (versione 2013-08-15 e versioni successive)

Di seguito è riportata una richiesta di esempio e una risposta che usa JSON.

PUT https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey',RowKey='myRowKey')  

La richiesta viene inviata con le intestazioni seguenti:

x-ms-version: 2013-08-15  
Content-Type: application/json  
x-ms-date: Tue, 30 Aug 2013 18:10:24 GMT  
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=  
Content-Length: 1135  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  

La richiesta viene inviata con il corpo JSON seguente:

{  
   "Address":"Santa Clara",  
   "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":false,  
   "NumberOfOrders@odata.type":"Edm.Int64",  
   "NumberOfOrders":"255",  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey"  
}  

Dopo l'invio della richiesta viene restituita la risposta seguente:

HTTP/1.1 204 No Content  
  
Connection: Keep-Alive  
x-ms-request-id: 2c085f8f-11a4-4e1d-bd49-82c6bd87649d  
Content-Length: 0  
Cache-Control: no-cache  
Date: Tue, 30 Aug 2013 18:12:54 GMT  
ETag: W/"0x5B168C7B6E589D2"  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  

Feed Atom (versioni precedenti al 2015-12-11)

Di seguito è riportata una richiesta di esempio e una risposta che usa Atom.

PUT https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey',RowKey='myRowKey')  

La richiesta viene inviata con le intestazioni seguenti:

x-ms-version: 2013-08-15  
Accept: application/atom+xml,application/xml  
Accept-Charset: UTF-8  
Content-Type: application/atom+xml  
x-ms-date: Tue, 12 Nov 2013 18:10:24 GMT  
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=  
Content-Length: 1135  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  

La richiesta viene inviata con il corpo XML seguente:

<?xml version="1.0" encoding="utf-8"?>  
<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 />  
  <updated>2013-11-12T18:09:37.168836Z</updated>  
  <author>  
    <name />  
  </author>  
<id>https://myaccount.table.core.windows.net/mytable(PartitionKey='mypartitionkey',RowKey='myrowkey1')</id>  
  <content type="application/xml">  
    <m:properties>  
      <d:Address>Santa Clara</d:Address>  
      <d:Age m:type="Edm.Int32">23</d:Age>  
      <d:AmountDue m:type="Edm.Double">200.23</d:AmountDue>  
      <d:CustomerCode m:type="Edm.Guid">c9da6455-213d-42c9-9a79-3e9149a57833</d:CustomerCode>  
      <d:CustomerSince m:type="Edm.DateTime">2008-07-10T00:00:00Z</d:CustomerSince>  
      <d:IsActive m:type="Edm.Boolean">false</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>  

Dopo l'invio della richiesta viene restituita la risposta seguente:

HTTP/1.1 204 No Content  
  
Connection: Keep-Alive  
x-ms-request-id: 2c085f8f-11a4-4e1d-bd49-82c6bd87649d  
Content-Length: 0  
Cache-Control: no-cache  
Date: Tue, 12 Nov 2013 18:12:54 GMT  
ETag: W/"0x5B168C7B6E589D2"  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  

Commenti

L'operazione Insert Or Replace Entity non usa l'intestazione If-Match . È necessario chiamare questa operazione usando la versione 2011-08-18 o successiva. Questi attributi distingueno questa operazione dall'operazione Aggiorna entità .

Se si usa l'operazione Insert Or Replace Entity per sostituire un'entità, le proprietà dell'entità precedente vengono rimosse, se la nuova entità non li definisce. Le proprietà con un null valore vengono rimosse anche.

Quando si chiama l'operazione Insert or Replace Entity , è necessario specificare i valori per le PartitionKey proprietà di sistema e RowKey . Insieme, queste proprietà formano la chiave primaria e devono essere univoci all'interno della tabella.

Entrambi i PartitionKey valori e RowKey devono essere valori stringa. Ogni valore chiave può essere fino a 64 KiB di dimensioni. Se si usa un valore integer per il valore della chiave, è necessario convertire l'intero in una stringa a larghezza fissa. Ciò è dovuto al fatto che sono ordinati canonicamente. Ad esempio, convertire il valore 1 in 0000001, per garantire l'ordinamento corretto.

Per digitare in modo esplicito una proprietà, specificare il tipo di dati appropriato OData impostando l'attributo m:type all'interno della definizione della proprietà nel feed Atom. Per altre informazioni sulla digitazione delle proprietà, vedere Inserimento e aggiornamento di entità.

Qualsiasi applicazione che può autorizzare e inviare una HTTP PUT richiesta può inserire o sostituire un'entità.

Per informazioni sull'esecuzione di operazioni upsert batch, vedere Esecuzione di transazioni del gruppo di entità.

Vedi anche

Autorizzare le richieste ad Archiviazione di Azure
Impostazione delle intestazioni della versione del servizio dati OData
Inserimento e aggiornamento di entità
Stato e codici errore
Codici di errore di Archiviazione tabelle