JavaScript kullanarak NoSQL için Azure Cosmos DB'de öğe oluşturma

Geçerli Olduğu Yerler: NoSQL

Azure Cosmos DB'deki öğeler, kapsayıcı içinde depolanan belirli bir varlığı temsil eder. NoSQL API'sinde bir öğe, benzersiz tanımlayıcıya sahip JSON biçimli verilerden oluşur.

Öğe, öğe tanımı ve öğe yanıtı

JavaScript SDK'sında, bir öğeyle ilgili üç nesnenin farklı amaçları vardır.

İsim	Operasyonlar
Öğe	Okuma, Düzeltme Eki, Değiştir, Sil gibi işlevler.
ItemDefinition	Özel veri nesneniz. id ve ttl özelliklerini otomatik olarak içerir.
ItemResponse	statusCode, item ve diğer özellikleri içerir.

İşlemin sonucunu anlamak için ItemResponse nesnesinin özelliklerini kullanın.

• statusCode: HTTP durum kodu. Başarılı bir yanıt 200-299 aralığındadır.
• activityId: oluşturma, okuma, değiştirme veya silme gibi işlemin benzersiz tanımlayıcısı.
• etag: Verilerle ilişkili varlık etiketi. İyimser eşzamanlılık, önbelleğe alma ve koşullu istekler için kullanın.
• item: Okuma, değiştirme, silme gibi işlemleri gerçekleştirmek için kullanılan öğe nesnesi.
• kaynak: Özel verileriniz.

Öğe için benzersiz tanımlayıcı oluşturma

Benzersiz tanımlayıcı, kapsayıcı içindeki bir öğeyi tanımlayan ayrı bir dizedir. id özelliği, yeni bir JSON belgesi oluştururken gereken tek özelliktir. Örneğin, bu JSON belgesi Azure Cosmos DB'de geçerli bir öğedir:

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

Kapsayıcı kapsamında iki öğe aynı benzersiz tanımlayıcıyı paylaşamaz.

Önemli

id özelliği harf duyarlılığına sahiptir. Özellikler ID, Id, iD, ve _id rastgele bir JSON özelliği olarak değerlendirilir.

Oluşturulduktan sonra, bir öğenin URI'si şu biçimdedir:

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

URI kullanarak öğeye başvururken, alan yerine sistem tarafından oluşturulan kaynak tanımlayıcısınıid kullanın. NoSQL için Azure Cosmos DB'de sistem tarafından oluşturulan öğe özellikleri hakkında daha fazla bilgi için bkz. Öğenin özellikleri

Öğe oluşturma

create yöntemini kullanarak kapsayıcının items nesnesiyle bir öğe oluşturun.

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

Öğeye erişme

Öğe nesnesi aracılığıyla bir öğeye erişin. Buna Container nesnesinden erişilebilir veya Database veya CosmosClient nesnelerinden değiştirilebilir.

// 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();

Nesneye göre erişim:

• Öğeler (çoğul): Oluştur, toplu işle, değişiklik akışını izle, tümünü oku, güncelle veya ekle, sorgula öğeleri.
• Öğe (tekil): Öğeyi okuma, düzeltme, değiştirme veya silme.

Bir öğeyi değiştirme

Verileri Item nesnesiyle değiştirme yöntemiyle değiştirin.

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

Bir öğeyi oku

Item nesnesinin okuma yöntemiyle en güncel verileri okuyun.

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

Öğeyi silme

Item nesnesinin delete yöntemiyle öğeyi silin.

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

Sonraki adımlar

Çeşitli öğeler oluşturduğunuza göre, öğeyi sorgulamak için sonraki kılavuzu kullanın.

Öğe okuma