Lampiran
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.