Membuat item di Azure Cosmos DB untuk NoSQL menggunakan JavaScript

BERLAKU UNTUK: NoSQL

Item di Azure Cosmos DB mewakili entitas tertentu yang disimpan dalam kontainer. Dalam API untuk NoSQL, item terdiri dari data berformat JSON dengan pengidentifikasi unik.

Item, definisi item, dan respons item

Di JavaScript SDK, tiga objek yang terkait dengan item memiliki tujuan yang berbeda.

Nama	Operasi
Item	Fungsionalitas termasuk Baca, Patch, Ganti, Hapus.
ItemDefinisi	Objek data kustom Anda. Termasuk properti id dan ttl secara otomatis.
ItemResponse	Termasuk statusCode, item, dan properti lainnya.

Gunakan properti objek ItemResponse untuk memahami hasil operasi.

• statusCode: Kode status HTTP. Respons yang berhasil berada dalam rentang 200-299.
• activityId: Pengidentifikasi unik untuk operasi seperti membuat, membaca, mengganti, atau menghapus.
• etag: Tag entitas yang terkait dengan data. Gunakan untuk konkurensi optimis, cache, dan permintaan kondisional.
• item: Objek item yang digunakan untuk melakukan operasi seperti baca, ganti, hapus.
• sumber daya: Data kustom Anda.

Membuat pengidentifikasi unik untuk item

Pengidentifikasi unik adalah string berbeda yang mengidentifikasi item dalam kontainer. Properti id adalah satu-satunya properti yang diperlukan saat membuat dokumen JSON baru. Misalnya, dokumen JSON ini adalah item yang valid di Azure Cosmos DB:

{
  "id": "unique-string-2309509"
}

Dalam cakupan kontainer, dua item tidak dapat berbagi pengidentifikasi unik yang sama.

Penting

Properti id ini sensitif terhadap huruf besar/kecil. Properti bernama ID, Id, iD, dan _id akan diperlakukan sebagai properti JSON arbitrer.

Setelah dibuat, URI untuk item berada dalam format ini:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>/docs/<item-resource-identifier>

Saat mereferensikan item menggunakan URI, gunakan pengidentifikasi sumber daya yang dihasilkan sistem alih-alih bidang id. Untuk informasi selengkapnya tentang properti item yang dihasilkan sistem di Azure Cosmos DB untuk NoSQL, lihat properti item

Membuat barang

Buat item dengan objek items kontainer menggunakan metode create.

const { statusCode, item, resource, activityId, etag} = await container.items.create({ 
        id: '2', 
        category: 'gear-surf-surfboards',
        name: 'Sunnox Surfboard',
        quantity: 8,
        sale: true 
    });

Mengakses item

Akses item melalui objek Item . Ini dapat diakses dari objek Kontainer atau diubah dari objek Database atau CosmosClient .

// Chained, then use a method of the Item object such as `read`
const { statusCode, item, resource, activityId, etag} = await client.database(databaseId).container(containerId).item(itemId).read();

Akses menurut objek:

• Item (jamak): Buat, batch, lihat umpan perubahan, baca semua, upsert, atau melakukan kueri pada item.
• Item (tunggal): Membaca, menambal, mengganti, atau menghapus item.

Mengganti item

Ganti data dengan objek Item dengan metode ganti .

const { statusCode, item, resource, activityId, etag} = await item.replace({ 
        id: '2', 
        category: 'gear-surf-surfboards-retro',
        name: 'Sunnox Surfboard Retro',
        quantity: 5,
        sale: false 
    });

Baca item

Baca data terbaru dengan metode baca objek Item.

const { statusCode, item, resource, activityId, etag} = await item.read();

Hapus barang

Hapus item dengan menggunakan metode delete dari objek Item.

const { statusCode, item, activityId, etag} = await item.delete();

Langkah berikutnya

Sekarang setelah Anda membuat berbagai item, gunakan panduan berikutnya untuk mencari item.

Baca item