Вставка и обновление сущностей
Чтобы вставить или обновить сущность, необходимо включить в запрос OData сущность ATOM или OData JSON, которая указывает свойства и данные для сущности. Дополнительные сведения о формате полезных данных см. в статье Формат полезных данных для операций хранилища таблиц Azure.
Операция вставки сущности вставляет новую сущность с уникальным первичным ключом, сформированным из сочетания ключа секции и ключа строки. Операция обновления сущности заменяет существующую сущность теми же PartitionKey и RowKey. Операция слияния сущностей обновляет свойства существующей сущности, но не заменяет сущность.
Операция вставки или слияния сущности создает новую сущность с уникальным первичным ключом или обновляет свойства существующей сущности, но не заменяет сущность. Операция вставки или замены сущности создает новую сущность с уникальным первичным ключом или заменяет существующую сущность.
Создание веб-канала Atom
Веб-канал Atom для операции вставки или обновления определяет свойства сущности, указывая их имена и типы данных, а также задает значения для этих свойств.
Элемент content содержит определения свойств сущности, которые указаны в элементе m:properties. Тип свойства указан атрибутом m:type. Подробные сведения о типах свойств см. в разделе Формат полезных данных для операций хранилища таблиц.
Ниже приведен пример веб-канала Atom для операции вставки сущности :
<?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>
Примечание
Полезные данные Atom поддерживаются только в версиях, предшествующих 11.12.2015. Начиная с версии 2015-12-11 полезные данные должны находиться в ФОРМАТЕ JSON.
Создание веб-канала JSON
Чтобы вставить или обновить сущность с помощью OData формата JSON, создайте объект JSON с именами свойств в качестве ключей и значениями свойств. Возможно, потребуется включить тип свойства, если его невозможно вывести с помощью OData эвристики обнаружения типа JSON.
Полезные данные JSON, соответствующие предыдущему примеру Atom, будут следующими:
{
"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"
}