Einfügen und Aktualisieren von Entitäten
Um eine Entität einzufügen oder zu aktualisieren, fügen Sie in die Anforderung eine OData ATOM- oder OData JSON-Entität ein, die die Eigenschaften und Daten für die Entität angibt. Weitere Informationen zum Format der Nutzlast finden Sie unter Nutzlastformat für Azure Table Storage-Vorgänge.
Der Vorgang Entität einfügen fügt eine neue Entität mit einem eindeutigen Primärschlüssel ein, der aus der Kombination des Partitionsschlüssels und des Zeilenschlüssels gebildet wird. Der Vorgang Entität aktualisieren ersetzt eine vorhandene Entität durch dieselbe PartitionKey und RowKey. Der Vorgang "Entität zusammenführen " aktualisiert die Eigenschaften einer vorhandenen Entität, ersetzt die Entität jedoch nicht.
Der Vorgang Entität einfügen oder zusammenführen erstellt eine neue Entität mit einem eindeutigen Primärschlüssel oder aktualisiert die Eigenschaften einer vorhandenen Entität, ersetzt die Entität jedoch nicht. Der Vorgang Entität einfügen oder ersetzen erstellt eine neue Entität mit einem eindeutigen Primärschlüssel oder ersetzt eine vorhandene Entität.
Erstellen des Atomfeeds
Der Atom-Feed für einen Einfüge- oder Updatevorgang definiert die Eigenschaften der Entität durch Angeben ihrer Namen und Datentypen und legt die Werte für diese Eigenschaften fest.
Das content-Element enthält die Eigenschaftsdefinitionen der Entität, die im m:properties-Element angegeben sind. Der Typ der Eigenschaft wird durch das m:type-Attribut angegeben. Ausführliche Informationen zu Eigenschaftentypen finden Sie unter Nutzlastformat für Tabellenspeichervorgänge.
Hier sehen Sie ein Beispiel für einen Atom-Feed für einen Vorgang "Entität einfügen" :
<?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>
Hinweis
Atom-Nutzlasten werden nur in Versionen vor 2015-12-11 unterstützt. Ab Version 2015-12-11 müssen die Nutzlasten in JSON enthalten sein.
Erstellen des JSON-Feeds
Um eine Entität im OData JSON-Format einzufügen oder zu aktualisieren, erstellen Sie ein JSON-Objekt mit Eigenschaftsnamen als Schlüsseln zusammen mit ihren Eigenschaftswerten. Möglicherweise müssen Sie den Eigenschaftstyp einschließen, wenn er nicht über OData JSON-Typerkennungsheuristiken abgeleitet werden kann.
Die JSON-Nutzlast, die dem vorherigen Atom-Beispiel entspricht, lautet wie folgt:
{
"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"
}