JavaScript kullanarak NoSQL için Azure Cosmos DB kullanmaya başlama

Bu makalede, JavaScript SDK'sını kullanarak NoSQL için Azure Cosmos DB'ye nasıl bağlanabileceğiniz gösterilmektedir. Bağlandıktan sonra veritabanları, kapsayıcılar ve öğeler üzerinde işlemler gerçekleştirebilirsiniz.

Paket (npm) | API referansı | Kitaplık kaynak kodu | Geri Bildirimde Bulun

Prerequisites

• Aktif bir aboneliğe sahip bir Azure hesabı. Ücretsiz bir hesap oluşturun.
• Azure Cosmos DB için NoSQL hesabı. NoSQL hesabı için bir API oluşturun.
• Node.js LTS
• Azure Komut Satırı Arayüzü (CLI) veya Azure PowerShell

Yerel projenizi ayarlama

1. Bash kabuğunda JavaScript projeniz için yeni bir dizin oluşturun.

   mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples
   

2. npm init şablonuyla komutunu kullanarak yeni bir JavaScript uygulaması oluşturun.

   npm init -y
   

3. NoSQL için Azure Cosmos DB JavaScript SDK'sı için gerekli bağımlılığı yükleyin.

   npm install @azure/cosmos
   

NoSQL için Azure Cosmos DB'ye Bağlan

Azure Cosmos DB'nin NoSQL API'sine bağlanmak için CosmosClient sınıfının bir örneğini oluşturun. Bu sınıf, veritabanları üzerinde tüm işlemleri gerçekleştirmek için başlangıç ​​noktasıdır.

Microsoft Entra kullanarak NoSQL hesabınıza yönelik API'ye bağlanmak için bir güvenlik ilkesi kullanın. Sorumlunun tam türü, uygulama kodunuzu nerede barındırdığınıza bağlıdır. Aşağıdaki tablo bir hızlı başvuru kılavuzu görevi görür.

Uygulamanın çalıştığı yer	Güvenlik sorumlusu
Yerel makine (geliştirme ve test)	Kullanıcı kimliği veya hizmet ilkesi
Azure	İdare edilen kimlik
Azure dışındaki sunucular veya istemciler	Servis Principal

İthalat @azure/identity

@azure/identity npm paketi, tüm Azure SDK kitaplıkları arasında paylaşılan temel kimlik doğrulama işlevselliğini içerir.

1. komutunu kullanarak @azure/identity npm paketini içeri aktarın npm install .

   npm install @azure/identity
   

2. Kod düzenleyicinizde bağımlılıkları ekleyin.

   const { DefaultAzureCredential } = require("@azure/identity");
   

Varsayılan kimlik bilgisi uygulamasıyla CosmosClient oluşturun.

Yerel bir makinede test ediyorsanız veya uygulamanız yönetilen kimlikler için doğrudan destek sunan Azure hizmetlerde çalışacaksa, DefaultAzureCredential örneği oluşturarak OAuth belirteci edinin. Ardından ortam değişkeni ve TokenCredential nesnesini parametre olarak kullanarak COSMOS_ENDPOINT sınıfının yeni bir örneğini oluşturun.

const { CosmosClient } = require("@azure/cosmos");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();

const cosmosClient = new CosmosClient({ 
    endpoint, 
    aadCredentials: credential
});

Uygulamanızı oluşturun

Uygulamanızı oluştururken kodunuz öncelikli olarak dört tür kaynakla etkileşim kurar:

• Azure Cosmos DB verileriniz için benzersiz üst düzey ad alanı olan NoSQL hesabı API'si.

• Hesabınızdaki kapları organize eden veritabanları.

• Veritabanınızda yer alan bir dizi bireysel öğeyi içeren kapsayıcılar.

• Containerınızdaki bir JSON belgesini temsil eden öğeler.

Aşağıdaki diyagramda bu kaynaklar arasındaki ilişki gösterilmektedir.

En üstte bir Azure Cosmos DB hesabını gösteren hiyerarşik diyagram. Hesabın iki alt veritabanı düğümü vardır. Veritabanı düğümlerinden biri, iki alt kapsayıcı düğüm içerir. Diğer veritabanı düğümü sadece tek bir alt kapsayıcı düğümü içerir. O tek konteyner düğümü, üç çocuk öğe düğümüne sahiptir.

Her kaynak türü bir veya daha fazla ilişkili sınıfla temsil edilir. En yaygın sınıfların listesi aşağıdadır:

Class	Description
CosmosClient	Bu sınıf, Azure Cosmos DB hizmeti için istemci taraflı bir mantıksal temsil sağlar. İstemci nesnesi, hizmette istekleri yapılandırmak ve yürütmek için kullanılır.
Database	Bu sınıf, hizmette henüz var olabilen veya var olmayan bir veritabanına başvurudur. Veritabanına erişmeye veya üzerinde bir işlem gerçekleştirmeye çalıştığınızda, veritabanı sunucu tarafında doğrulanır.
Container	Bu sınıf, hizmette henüz mevcut olmayan bir kapsayıcıya referanstır. Kapsayıcıyla çalışmaya başladığınızda, sunucu tarafında doğrulama yapılır.

Aşağıdaki kılavuzlarda, uygulamanızı derlemek için bu sınıfların her birinin nasıl kullanılacağı gösterilmektedir.

Guide	Description
Veritabanı oluşturma	Veritabanları oluşturun
Kapsayıcı oluşturma	Konteynerler oluştur
Öğe oluşturma ve okuma	Belirli bir öğeyi nokta üzerinden okuma
Sorgu öğeleri	Birden çok öğeyi sorgulama

Ayrıca bakınız

• npm paketi
• API başvurusu
• Kütüphane kaynak kodu
• Geri BildirimDe bulunmak

Sonraki Adımlar

JavaScript kullanarak NoSQL için Azure Cosmos DB'de veritabanı oluşturma