Partilhar via


Inserir e atualizar entidades

Para inserir ou atualizar uma entidade, inclua com o pedido uma OData entidade ATOM ou OData JSON que especifica as propriedades e os dados da entidade. Para obter mais informações sobre o formato do payload, veja Formato de payload 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 Intercalar Entidade atualiza as propriedades de uma entidade existente, mas não substitui a entidade.

A operação Inserir ou Intercalar 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 ao especificar os respetivos nomes e tipos de dados e define os valores dessas propriedades.

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

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

Nota

Os payloads atom só são suportados em versões anteriores a 2015-12-11. A partir da versão 2015-12-11, os payloads têm de estar em JSON.

Construir o feed JSON

Para inserir ou atualizar uma entidade com o OData formato JSON, crie um objeto JSON com nomes de propriedade como chaves, juntamente com os respetivos valores de propriedade. Poderá ter de incluir o tipo de propriedade se não puder ser inferido através OData da heurística de deteção de tipo JSON.

O payload JSON correspondente ao exemplo Atom anterior é o 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"  
}  
  

Ver também

Conceitos do Armazenamento de Tabelas
Operações em entidades