銷售: 1-800-867-1380

插入及更新實體

更新日期: 2015年4月

若要插入或更新實體,可在要求中包含 OData ATOM 或 OData JSON 實體,以指定實體的屬性和資料。如需裝載格式的相關詳細資訊,請參閱<表格服務作業的裝載格式>。

插入實體 作業會插入含有唯一主索引鍵 (由 PartitionKey 和 RowKey 組合構成) 的新實體。更新實體 作業以相同的 PartitionKeyRowKey 取代現有的實體。合併實體 作業會更新現有實體的屬性,但是不會取代實體。插入或合併實體 作業會以唯一主索引鍵建立新的實體,或是更新現有實體的屬性,但是不會取代實體。插入或取代實體 作業會以唯一主索引鍵建立新的實體,或是取代現有的實體。

插入或更新作業的 Atom 摘要,會藉由指定屬性名稱和資料類型,定義實體的屬性,並且設定那些屬性的值。

content 元素包含實體的屬性定義 (指定於 m:properties 元素中)。屬性 (property) 的類型是以 m:type 屬性 (attribute) 指定。如需屬性類型的詳細資訊,請參閱<表格服務作業的裝載格式>。

以下是用於 插入實體 作業的 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="http://www.w3.org/2005/Atom">
  <title />
  <updated>2008-09-18T23:46:19.3857256Z<updated/>
  <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>
      <d:Timestamp m:type="Edm.DateTime">0001-01-01T00:00:00</d:Timestamp>
    </m:properties>
  </content>
</entry>

請注意,插入或更新作業的 Atom 摘要必須包含 updated 元素,代表時間戳記元素,如 Atom 同步發佈格式所定義。updated 元素指定為字串,並使用目前的組合 UTC 時間。其格式如下列範例所示:

2009-03-18T04:25:03Z

如需建構 updated 元素和其他 DateTime 值的詳細資訊,請參閱<格式化 DateTime 屬性值>。

如果要使用 OData JSON 格式插入或更新實體,請建立具有屬性名稱作為索引鍵以及屬性值的 JSON 物件。如果無法透過 OData JSON 類型偵測啟發學習法進行推斷,您可能需要包含屬性類型。如需屬性類型偵測啟發學習法以及使用 JSON OData 的資訊,請參閱<表格服務作業的裝載格式>。

與上述 ATOM 範例對應的 JSON 裝載如下:

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

另請參閱

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2015 Microsoft