Hızlı Başlangıç: Node.js ile MongoDB için Azure Cosmos DB kullanma

• .NET
• Node.js
• Python

Bu hızlı başlangıçta Python kullanarak MongoDB için temel bir Azure Cosmos DB uygulaması dağıtacaksınız. MongoDB için Azure Cosmos DB, uygulamaların MongoDB kitaplıklarıyla yapılandırılmamış belgeleri bulutta depolamasına olanak sağlayan şemasız bir veri deposudur. Python kullanarak Azure Cosmos DB kaynağınızda belge oluşturmayı ve temel görevleri gerçekleştirmeyi öğrenirsiniz.

Kitaplık kaynak kodu | npm Paketi | Azure Geliştirici Komut Satırı Araçları

Önkoşullar

• Azure Geliştirici CLI
• Docker Desktop
• Node.js 22 veya üzeri

Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.

Projeyi başlatma

Tablo hesabı için Azure Cosmos DB oluşturmak ve kapsayıcılı örnek bir uygulama dağıtmak için Azure Geliştirici CLI'sini (azd) kullanın. Örnek uygulama örnek verileri yönetmek, oluşturmak, okumak ve sorgulamak için istemci kitaplığını kullanır.

1. Boş bir dizinde bir terminal açın.

2. Henüz kimlik doğrulaması yapmadıysanız, azd auth login ile Azure Geliştirici CLI'sinde kimlik doğrulaması yapın. Tercih ettiğiniz Azure kimlik bilgilerini kullanarak CLI'da kimlik doğrulaması yapmak için araç tarafından belirtilen adımları izleyin.

   azd auth login
   

3. Projeyi başlatmak için kullanın azd init .

   azd init --template cosmos-db-mongodb-nodejs-quickstart
   

4. Başlatma sırasında benzersiz bir ortam adı yapılandırın.

5. Kullanarak azd upAzure Cosmos DB hesabını dağıtın. Bicep şablonları ayrıca örnek bir web uygulaması dağıtır.

   azd up
   

6. Sağlama işlemi sırasında aboneliğinizi, istediğiniz konumu ve hedef kaynak grubunu seçin. Sağlama işleminin tamamlanmasını bekleyin. İşlem yaklaşık beş dakika sürebilir.

7. Azure kaynaklarınızın sağlanması tamamlandıktan sonra, çalışan web uygulamasının URL'si çıktıya eklenir.

   Deploying services (azd deploy)
   
     (✓) Done: Deploying service web
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
   

8. Tarayıcıda web uygulamanıza gitmek için konsoldaki URL'yi kullanın. Çalışan uygulamanın çıktısını gözlemleyin.

İstemci kitaplığını yükleme

İstemci kitaplığı npm aracılığıyla paket olarak mongodb kullanılabilir.

1. Bir terminal açın ve klasöre /src/ts gidin.

   cd ./src/ts
   

2. Henüz yüklü değilse, mongodb paketini npm install kullanarak yükleyin.

   npm install --save mongodb
   

3. Girdinin dosyasını açın ve gözden geçirin.

1. Bir terminal açın ve klasöre /src/js gidin.

   cd ./src/js
   

2. Henüz yüklü değilse, mongodb paketini npm install kullanarak yükleyin.

   npm install --save mongodb
   

3. Girdinin dosyasını açın ve gözden geçirin.

Kitaplıkları içeri aktarma

MongoClient Türü uygulama kodunuz içine aktarın.

import { MongoClient } from 'mongodb';

Tüm gerekli türleri uygulama kodunuz içine aktar.

import { Collection, Db, Filter, FindCursor, MongoClient, UpdateFilter, UpdateOptions, UpdateResult, WithId } from 'mongodb';

Nesne modeli

Veri Akışı Adı	Açıklama
MongoClient	MongoDB'ye bağlanmak için kullanılan tür.
Database	Hesaptaki bir veritabanını temsil eder.
Collection	Hesaptaki veritabanındaki bir koleksiyonu temsil eder.

Kod örnekleri

• İstemcinin kimliğini doğrulama
• Veritabanı alma
• Koleksiyon edin
• Belge oluşturma
• Bir belge alın
• Belgeleri sorgulama

Şablondaki örnek kod, cosmicworks adlı bir veritabanı ve products adlı bir koleksiyonu kullanır. Koleksiyon ad products , kategori, miktar ve her ürün için benzersiz tanımlayıcı gibi ayrıntıları içerir. Koleksiyon, /category özelliğini parça anahtarı olarak kullanır.

İstemcinin kimliğini doğrulama

Bu örnek türün yeni bir örneğini MongoClient oluşturur.

const connectionString = "<azure-cosmos-db-for-mongodb-connection-string>";

const client = new MongoClient(connectionString);

const connectionString = "<azure-cosmos-db-for-mongodb-connection-string>";

const client = new MongoClient(connectionString);

Veritabanı alma

Bu örnek, Db işlevini kullanarak db türünün bir örneğini MongoClient oluşturur.

const database: Db = client.db("<database-name>");

const database = client.db("<database-name>");

Koleksiyon alma

Bu örnek, Collection işlevini kullanarak collection türünün bir örneğini Db oluşturur.

Bu işlev, bir arabirimde tanımlanan türü kullanan genel bir parametreye Product sahiptir.

const collection: Collection<Product> = database.collection<Product>("<collection-name>");

export interface Product {
    _id: string;
    category: string;
    name: string;
    quantity: number;
    price: number;
    clearance: boolean;
}

const collection = database.collection("<collection-name>");

Belge oluşturma

kullanarak collection.updateOnekoleksiyonda bir belge oluşturun. Bu yöntem, zaten varsa öğeyi etkili bir şekilde değiştirerek öğeyi "upsert" eder.

var document: Product = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards',
    name: 'Yamba Surfboard',
    quantity: 12,
    price: 850.00,
    clearance: false
};

var query: Filter<Product> = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards'
};
var payload: UpdateFilter<Product> = {
    $set: document
};
var options: UpdateOptions = {
    upsert: true
};
var response: UpdateResult<Product> = await collection.updateOne(query, payload, options);

var document = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards',
    name: 'Yamba Surfboard',
    quantity: 12,
    price: 850.00,
    clearance: false
};

const query = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards'
};
const payload = {
    $set: document
};
const options = {
    upsert: true,
    new: true
};
var response = await collection.updateOne(query, payload, options);

Belgeyi okuma

Hem benzersiz tanımlayıcıyı (id) hem de parça anahtarı alanlarını kullanarak bir nokta okuma işlemi gerçekleştirin. Belirli bir öğeyi verimli bir şekilde almak için kullanın collection.findOne .

var query: Filter<Product> = { 
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb', 
    category: 'gear-surf-surfboards' 
};

var response: WithId<Product> | null = await collection.findOne(query);

var query = { 
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb', 
    category: 'gear-surf-surfboards' 
};

var response = await collection.findOne(query);

Belgeleri sorgulama

kullanarak collection.findbir kapsayıcıdaki birden çok öğe üzerinde sorgu gerçekleştirin. Bu sorgu, belirtilen kategorideki (parça anahtarı) tüm öğeleri bulur.

var query: Filter<Product> = { 
    category: 'gear-surf-surfboards' 
};

var response: FindCursor<WithId<Product>> = await collection.find(query);

for await (const item of response) {
    // Do something with each item
}

var query = { 
    category: 'gear-surf-surfboards' 
};

var response = await collection.find(query);

for await (const item of response) {
    // Do something with each item
}

Verilerinizi keşfetme

MongoDB verilerinizi keşfetmek için Azure Cosmos DB için Visual Studio Code uzantısını kullanın. Aşağıdakiler dahil ancak bunlarla sınırlı olmamak üzere temel veritabanı işlemleri gerçekleştirebilirsiniz:

• Yapıştırma defteri veya sorgu düzenleyicisi kullanarak sorgu gerçekleştirme
• Belgeleri değiştirme, güncelleştirme, oluşturma ve silme
• Diğer kaynaklardan toplu verileri içeri aktarma
• Veritabanlarını ve koleksiyonları yönetme

Daha fazla bilgi için bkz MongoDB için Azure Cosmos DB verilerini keşfetmek amacıyla Visual Studio Code uzantısını kullanma.

Kaynakları temizleme

Örnek uygulamaya veya kaynaklara artık ihtiyacınız kalmadığında, ilgili dağıtımı ve tüm kaynakları kaldırın.

azd down --force --purge

İlgili içerik

• .NET Hızlı Başlangıcı
• Python Hızlı Başlangıcı