Insérer et mettre à jour des entités
Pour insérer ou mettre à jour une entité, vous incluez dans la demande une OData entité ATOM ou OData JSON qui spécifie les propriétés et les données de l’entité. Pour plus d’informations sur le format de la charge utile, consultez Format de charge utile pour les opérations de stockage Table Azure.
L’opération Insérer une entité insère une nouvelle entité avec une clé primaire unique, formée à partir de la combinaison de la clé de partition et de la clé de ligne.
L’opération De mise à jour de l’entité remplace une entité existante par les mêmes PartitionKey et RowKey. L’opération Fusionner l’entité met à jour les propriétés d’une entité existante, mais ne remplace pas l’entité.
L’opération Insérer ou fusionner une entité crée une entité avec une clé primaire unique ou met à jour les propriétés d’une entité existante, mais ne remplace pas l’entité. L’opération Insérer ou remplacer une entité crée une entité avec une clé primaire unique ou remplace une entité existante.
Construire le flux Atom
Le flux Atom pour une opération d'insertion ou de mise à jour définit les propriétés de l'entité en spécifiant leurs noms et types de données, et définit les valeurs pour ces propriétés.
L'élément content contient les définitions de la propriété de l'entité, qui sont spécifiées dans l'élément m:properties. Le type de la propriété est spécifié par l'attribut m:type. Pour plus d’informations sur les types de propriétés, consultez Format de charge utile pour les opérations de stockage table.
Voici un exemple de flux Atom pour une opération Insérer une 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>
Remarque
Les charges utiles Atom sont prises en charge uniquement dans les versions antérieures à 2015-12-11. À compter de la version 2015-12-11, les charges utiles doivent être au format JSON.
Construire le flux JSON
Pour insérer ou mettre à jour une entité à l’aide du OData format JSON, créez un objet JSON avec des noms de propriétés en tant que clés, ainsi que leurs valeurs de propriété. Vous devrez peut-être inclure le type de propriété s’il ne peut pas être déduit via OData l’heuristique de détection de type JSON.
La charge utile JSON correspondant à l’exemple Atom précédent est la suivante :
{
"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"
}