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

  • Şunlara uygulanır: ✅ 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.

Name Operasyonlar
Öğe Okuma, Yama, Değiştir, Sil ve benzeri işlevler.
ItemDefinition Özel veri nesneniz. id ve ttl özelliklerini otomatik olarak ekler.
ItemResponse Şunları içerir: statusCode, item ve diğer özellikler.

İş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.

Important

id özelliği büyük/küçük harfe duyarlıdır. ID, Id, iD ve _id adlı özellikler rastgele bir JSON özelliği olarak değerlendirilecektir.

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şturma, toplu işlem, değişiklik akışını izleme, tümünü okuma, upsert veya sorgu öğeleri.
  • Öğe (tekil): Öğeyi oku, yama yap, değiştir veya sil.

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 
    });

Öğeyi oku

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

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

Öğe 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.

Bir öğeyi oku

  • Last updated on