Compartir a través de


Insertar y actualizar entidades

Para insertar o actualizar una entidad, incluya con la solicitud una OData entidad ATOM o OData JSON que especifique las propiedades y los datos de la entidad. Para más información sobre el formato de la carga, consulte Formato de carga para las operaciones de Azure Table Storage.

La operación Insertar entidad inserta una nueva entidad con una clave principal única, formada a partir de la combinación de la clave de partición y la clave de fila. La operación Actualizar entidad reemplaza una entidad existente por las mismas PartitionKey y RowKey. La operación Merge Entity actualiza las propiedades de una entidad existente, pero no reemplaza a la entidad.

La operación Insertar o combinar entidad crea una nueva entidad con una clave principal única o actualiza las propiedades de una entidad existente, pero no reemplaza la entidad. La operación Insertar o reemplazar entidad crea una nueva entidad con una clave principal única o reemplaza una entidad existente.

Construcción de la fuente Atom

En una operación de inserción o actualización, la fuente Atom define las propiedades de la entidad especificando sus nombres y tipos de datos, y establece los valores de esas propiedades.

El elemento content contiene las definiciones de propiedades de la entidad, que se especifican en el elemento m:properties. El tipo de propiedad se especifica mediante el atributo m:type. Para obtener información detallada sobre los tipos de propiedad, consulte Formato de carga para las operaciones de Table Storage.

Este es un ejemplo de una fuente Atom para una operación insertar entidad :

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

Las cargas de Atom solo se admiten en versiones anteriores a 2015-12-11. A partir de la versión 2015-12-11, las cargas deben estar en JSON.

Construcción de la fuente JSON

Para insertar o actualizar una entidad mediante el OData formato JSON, cree un objeto JSON con nombres de propiedad como claves, junto con sus valores de propiedad. Es posible que tenga que incluir el tipo de propiedad si no se puede deducir a través OData de la heurística de detección de tipos JSON.

La carga JSON correspondiente al ejemplo de Atom anterior es la siguiente:

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

Consulte también

Conceptos de Table Storage
Operaciones en entidades