Baca dalam bahasa Inggris

Bagikan melalui

Lampiran

  • Artikel

Azure Cosmos DB adalah database multi-model yang didistribusikan secara global yang mendukung model data dokumen, grafik, cassandra, dan tabel. Konten di bagian ini adalah untuk mengelola sumber daya lampiran menggunakan SQL API melalui REST.

Lampiran adalah dokumen khusus yang berisi referensi dan metadata terkait dengan blob eksternal atau file media.

Pengembang dapat memilih untuk memiliki:

  • Media/blob lampiran yang dikelola oleh Azure Cosmos DB atau
  • Simpan dengan penyedia layanan blob eksternal seperti OneDrive, Dropbox, dll. dan simpan metadata referensi untuk lampiran di Azure Cosmos DB.

Sumber daya lampiran diwakili oleh lampiran dalam model sumber daya Rest Azure Cosmos DB. Sumber daya lampiran memiliki skema tetap. Terlepas dari di mana media mentah disimpan, properti berikut diperlukan.

Contoh berikut mengilustrasikan konstruksi JSON dari lampiran dokumen.

{    
   "id":"image13d65101-90c4-4c2a-a423-fbf221c73233",  
   "contentType":"image/jpg",  
   "media":"www.bing.com",  
   "_rid":"rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_ts":1408056025,  
   "_self":"dbs\/rnYYAA==\/colls\/rnYYAMVFUAU=\/docs\/rnYYAMVFUAUBAAAAAAAAAA==\/attachments\/rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_etag":"00002a00-0000-0000-0000-53ed3ad90000"  
}
Properti Deskripsi
id Wajib diisi. Ini adalah properti yang dapat diatur pengguna. Ini adalah nama unik yang mengidentifikasi lampiran, yaitu, tidak ada dua lampiran yang memiliki ID yang sama untuk dokumen yang sama. ID tidak boleh melebihi 255 karakter.
contentType Wajib diisi. Ini adalah properti yang dapat diatur pengguna. Ini menentukan jenis konten lampiran. Saat mengirimkan bit lampiran sebagai isi, Cosmos DB mengatur contentType ke jenis yang diatur di Content-Type header.
Media Wajib diisi. Ini adalah tautan URL atau jalur file tempat lampiran berada.
_rid Ini adalah properti yang dihasilkan sistem. ID sumber daya (_rid) adalah pengidentifikasi unik yang juga hierarkis per tumpukan sumber daya pada model sumber daya. Ini digunakan secara internal untuk penempatan dan navigasi sumber daya lampiran.
_ts Ini adalah properti yang dihasilkan sistem. Ini menentukan tanda waktu terakhir yang diperbarui dari sumber daya. Nilainya adalah tanda waktu.
_self Ini adalah properti yang dihasilkan sistem. Ini adalah URI unik yang dapat diatasi untuk sumber daya.
_etag Ini adalah properti yang dihasilkan sistem yang menentukan etag sumber daya yang diperlukan untuk kontrol konkurensi optimis.

Header respons umum

Informasi berikut ini umum untuk semua respons yang terkait dengan lampiran:

Header Deskripsi
x-ms-max-media-storage-usage-mb Saat menggunakan penyimpanan lampiran Cosmos DB untuk menyimpan media mentah, header ini menunjukkan total kuota penyimpanan lampiran yang dialokasikan untuk akun tersebut.
x-ms-media-storage-usage-mb Saat menggunakan penyimpanan lampiran Cosmos DB untuk menyimpan media mentah, header ini menunjukkan penyimpanan lampiran saat ini yang digunakan.

Tugas

Anda dapat melakukan tugas-tugas ini dengan lampiran:

Isi lampiran tidak diindeks atau dapat dicari; properti sumber daya lampiran diindeks dan dapat dicari.

Operasi ini mirip dengan yang untuk Dokumen. Alih-alih melakukan operasi terhadap dokumen, operasi dilakukan terhadap jalur sumber daya lampiran di bawah dokumen tertentu. Oleh karena itu, kami akan melewati penguraian setiap operasi. Sebagai gantinya, di bagian berikutnya, kita akan membahas cara membuat lampiran dengan posting media mentah dan dengan posting khusus metadata.

Lihat juga