Inserir e atualizar entidades

Para inserir ou atualizar uma entidade, você inclui com a solicitação uma OData entidade ATOM ou OData JSON que especifica as propriedades e os dados da entidade. Para obter mais informações sobre o formato da carga, consulte Formato de carga para operações do Armazenamento de Tabelas do Azure.

A operação Inserir Entidade insere uma nova entidade com uma chave primária exclusiva, formada a partir da combinação da chave de partição e da chave de linha. A operação Atualizar Entidade substitui uma entidade existente pelo mesmo PartitionKey e RowKey. A operação Mesclar Entidade atualiza as propriedades de uma entidade existente, mas não substitui a entidade.

A operação Inserir ou Mesclar Entidade cria uma nova entidade com uma chave primária exclusiva ou atualiza as propriedades de uma entidade existente, mas não substitui a entidade. A operação Inserir ou Substituir Entidade cria uma nova entidade com uma chave primária exclusiva ou substitui uma entidade existente.

Construir o feed atom

O feed Atom para uma operação de inserção ou atualização define as propriedades da entidade especificando seus nomes e tipos de dados e define os valores dessas propriedades.

O elemento content contém as definições de propriedade da entidade, que são especificadas no elemento m:properties. O tipo de propriedade é especificado pelo atributo m:type. Para obter informações detalhadas sobre tipos de propriedade, consulte Formato de carga para operações de Armazenamento de Tabelas.

Aqui está um exemplo de um feed Atom para uma operação Inserir Entidade :

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

Observação

Cargas atom têm suporte apenas em versões anteriores a 2015-12-11. A partir da versão 2015-12-11, as cargas devem estar em JSON.

Construir o feed JSON

Para inserir ou atualizar uma entidade usando o OData formato JSON, crie um objeto JSON com nomes de propriedade como chaves, juntamente com seus valores de propriedade. Talvez seja necessário incluir o tipo de propriedade se ele não puder ser inferido por meio OData de heurística de detecção de tipo JSON.

A carga JSON correspondente ao exemplo atom anterior é a seguinte:

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

Confira também

Conceitos do Armazenamento de Tabelas
Operações em entidades