Aracılığıyla paylaş

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

  • Makale

UYGULANANLAR: 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.

Veri Akışı Adı Operations
Kalem Okuma, Düzeltme Eki, Değiştir, Sil gibi işlevler.
ItemDefinition Özel veri nesneniz. ttl Ve özelliklerini otomatik olarak eklerid.
ItemResponse , itemve diğer özellikleri içerirstatusCode.

İş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 büyük/küçük harfe duyarlıdır. , , IdiDve _id adlı IDözellikler 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şturma, toplu işlem, değişiklik akışını izleme, tümünü okuma, upsert veya sorgu öğeleri.
  • Öğe (tekil): Öğeyi okuma, düzeltme eki uygulama, 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 
    });

Öğe okuma

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