Udostępnij za pośrednictwem


Wstawianie i aktualizowanie jednostek

Aby wstawić lub zaktualizować jednostkę, dołącz do żądania jednostkę OData ATOM lub OData JSON, która określa właściwości i dane dla jednostki. Aby uzyskać więcej informacji na temat formatu ładunku, zobacz Payload format for Azure Table Storage operations (Format ładunku dla operacji usługi Azure Table Storage).

Operacja Wstaw jednostkę wstawia nową jednostkę z unikatowym kluczem podstawowym utworzonym na podstawie kombinacji klucza partycji i klucza wiersza. Operacja Aktualizuj jednostkę zastępuje istniejącą jednostkę tą samą PartitionKey i RowKey. Operacja Scal jednostkę aktualizuje właściwości istniejącej jednostki, ale nie zastępuje jednostki.

Operacja Wstawianie lub scalanie jednostki tworzy nową jednostkę z unikatowym kluczem podstawowym lub aktualizuje właściwości istniejącej jednostki, ale nie zastępuje jednostki. Operacja Wstaw lub Zamień jednostkę tworzy nową jednostkę z unikatowym kluczem podstawowym lub zastępuje istniejącą jednostkę.

Konstruowanie źródła danych Atom

Źródło danych Atom dla operacji wstawiania lub aktualizacji definiuje właściwości jednostki, określając ich nazwy i typy danych oraz ustawia wartości tych właściwości.

Element content zawiera definicje właściwości jednostki, które są określone w elemecie m:properties . Typ właściwości jest określony przez m:type atrybut . Aby uzyskać szczegółowe informacje o typach właściwości, zobacz Format ładunku dla operacji usługi Table Storage.

Oto przykład źródła danych Atom dla operacji Wstaw jednostkę:

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

Uwaga

Ładunki atomów są obsługiwane tylko w wersjach wcześniejszych niż 2015-12-11. Począwszy od wersji 2015-12-11, ładunki muszą znajdować się w formacie JSON.

Konstruowanie źródła danych JSON

Aby wstawić lub zaktualizować jednostkę przy użyciu OData formatu JSON, utwórz obiekt JSON z nazwami właściwości jako kluczami wraz z ich wartościami właściwości. Może być konieczne uwzględnienie typu właściwości, jeśli nie można wywnioskować go za pomocą OData heurystyki wykrywania typu JSON.

Ładunek JSON odpowiadający poprzedniemu przykładowi atomu jest następujący:

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

Zobacz też

Pojęcia dotyczące usługi Table Storage
Operacje na jednostkach