Sisipkan atau Ganti Entitas

Operasi Insert Or Replace Entity menggantikan entitas yang ada, atau menyisipkan entitas baru jika tidak ada dalam tabel. Karena operasi ini dapat menyisipkan atau memperbarui entitas, operasi ini juga dikenal sebagai operasi upsert .

Minta

Anda dapat membuat Insert Or Replace Entity permintaan sebagai berikut. HTTPS disarankan. Ganti nilai berikut dengan nilai Anda sendiri:

• myaccount dengan nama akun penyimpanan Anda

• mytable dengan nama tabel Anda

• myPartitionKey dan myRowKey dengan nama kunci partisi dan kunci baris untuk entitas yang akan diperbarui

Layanan penyimpanan yang ditimulasi

Saat Anda membuat permintaan terhadap layanan penyimpanan yang ditimulasi, tentukan nama host emulator dan port Azure Table Storage sebagai 127.0.0.1:10002, diikuti dengan nama akun penyimpanan yang ditimulasi.

Table Storage di emulator Storage berbeda dari Azure Table Storage dalam beberapa cara. Untuk informasi selengkapnya, lihat Perbedaan antara emulator Penyimpanan dan layanan Azure Storage.

Parameter URI

Anda dapat menentukan parameter tambahan berikut pada URI permintaan.

Header permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Isi permintaan

Operasi Insert Or Replace Entity mengirimkan entitas yang akan disisipkan sebagai OData set entitas. Set entitas ini dapat berupa JSON atau umpan Atom. Untuk informasi selengkapnya, lihat Menyisipkan dan memperbarui entitas.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode status

Operasi yang berhasil mengembalikan kode status 204 (Tanpa Konten). Untuk informasi tentang kode status, lihat Kode status dan kesalahan, dan kode kesalahan Table Storage.

Header respons

Respons mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Isi Respons

Tidak ada.

Authorization

Pemilik akun dapat melakukan operasi ini. Selain itu, siapa pun dengan tanda tangan akses bersama yang memiliki izin untuk melakukan operasi ini dapat melakukannya.

Sampel permintaan dan respons

Contoh berikut menunjukkan contoh permintaan yang menggunakan umpan JSON dan Atom.

JSON (versi 2013-08-15 dan yang lebih baru)

Berikut ini adalah contoh permintaan dan respons yang menggunakan JSON.

PUT https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey',RowKey='myRowKey')  

Permintaan dikirim dengan header berikut:

x-ms-version: 2013-08-15  
Content-Type: application/json  
x-ms-date: Tue, 30 Aug 2013 18:10:24 GMT  
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=  
Content-Length: 1135  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  

Permintaan dikirim dengan isi JSON berikut:

{  
   "Address":"Santa Clara",  
   "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":false,  
   "NumberOfOrders@odata.type":"Edm.Int64",  
   "NumberOfOrders":"255",  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey"  
}  

Setelah permintaan dikirim, respons berikut dikembalikan:

HTTP/1.1 204 No Content  
  
Connection: Keep-Alive  
x-ms-request-id: 2c085f8f-11a4-4e1d-bd49-82c6bd87649d  
Content-Length: 0  
Cache-Control: no-cache  
Date: Tue, 30 Aug 2013 18:12:54 GMT  
ETag: W/"0x5B168C7B6E589D2"  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  

Umpan atom (versi sebelum 2015-12-11)

Berikut ini adalah contoh permintaan dan respons yang menggunakan Atom.

PUT https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey',RowKey='myRowKey')  

Permintaan dikirim dengan header berikut:

x-ms-version: 2013-08-15  
Accept: application/atom+xml,application/xml  
Accept-Charset: UTF-8  
Content-Type: application/atom+xml  
x-ms-date: Tue, 12 Nov 2013 18:10:24 GMT  
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=  
Content-Length: 1135  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  

Permintaan dikirim dengan isi XML berikut:

<?xml version="1.0" encoding="utf-8"?>  
<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 />  
  <updated>2013-11-12T18:09:37.168836Z</updated>  
  <author>  
    <name />  
  </author>  
<id>https://myaccount.table.core.windows.net/mytable(PartitionKey='mypartitionkey',RowKey='myrowkey1')</id>  
  <content type="application/xml">  
    <m:properties>  
      <d:Address>Santa Clara</d:Address>  
      <d:Age m:type="Edm.Int32">23</d:Age>  
      <d:AmountDue m:type="Edm.Double">200.23</d:AmountDue>  
      <d:CustomerCode m:type="Edm.Guid">c9da6455-213d-42c9-9a79-3e9149a57833</d:CustomerCode>  
      <d:CustomerSince m:type="Edm.DateTime">2008-07-10T00:00:00Z</d:CustomerSince>  
      <d:IsActive m:type="Edm.Boolean">false</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>  

Setelah permintaan dikirim, respons berikut dikembalikan:

HTTP/1.1 204 No Content  
  
Connection: Keep-Alive  
x-ms-request-id: 2c085f8f-11a4-4e1d-bd49-82c6bd87649d  
Content-Length: 0  
Cache-Control: no-cache  
Date: Tue, 12 Nov 2013 18:12:54 GMT  
ETag: W/"0x5B168C7B6E589D2"  
DataServiceVersion: 1.0;NetFx  
MaxDataServiceVersion: 2.0;NetFx  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  

Keterangan

Operasi Insert Or Replace Entity tidak menggunakan If-Match header . Anda harus memanggil operasi ini dengan menggunakan versi 2011-08-18 atau yang lebih baru. Atribut ini membedakan operasi ini dari operasi Perbarui Entitas .

Jika Anda menggunakan Insert Or Replace Entity operasi untuk mengganti entitas, properti apa pun dari entitas sebelumnya akan dihapus, jika entitas baru tidak menentukannya. Properti dengan null nilai juga dihapus.

Saat Anda memanggil Insert or Replace Entity operasi, Anda harus menentukan nilai untuk PartitionKey properti sistem dan RowKey . Bersama-sama, properti ini membentuk kunci primer, dan harus unik dalam tabel.

PartitionKey Nilai dan RowKey harus berupa nilai string. PartitionKey dan RowKey nilai dapat berukuran hingga 1024 karakter. Jika Anda menggunakan nilai bilangan bulat untuk nilai kunci, Anda harus mengonversi bilangan bulat menjadi string lebar tetap. Ini karena mereka diurutkan secara kanonis. Misalnya, konversikan nilai 1 ke 0000001, untuk memastikan pengurutan yang tepat.

Untuk mengetik properti secara eksplisit, tentukan jenis data yang sesuai OData dengan mengatur m:type atribut dalam definisi properti di umpan Atom. Untuk informasi selengkapnya tentang mengetik properti, lihat Menyisipkan dan memperbarui entitas.

Aplikasi apa pun yang dapat mengotorisasi dan mengirim HTTP PUT permintaan dapat menyisipkan atau mengganti entitas.

Untuk informasi tentang melakukan operasi upsert batch, lihat Melakukan transaksi grup entitas.

Lihat juga

Mengotorisasi permintaan ke Azure Storage
Mengatur header versi layanan data OData
Menyisipkan dan memperbarui entitas
Status dan kode galat
Kode kesalahan Table Storage