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

Makale
10/02/2024

UYGULANANLAR: NoSQL

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) | Örnekler | API başvurusu | Kitaplık kaynak kodu | Geri BildirimDeğer Ver

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
NoSQL için Azure Cosmos DB hesabı. NoSQL hesabı için bir API oluşturun.
Node.js LTS
Azure Komut Satırı Arabirimi (CLI) veya Azure PowerShell

Yerel projenizi ayarlama

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

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

konsol şablonuyla komutunu kullanarak npm init yeni bir JavaScript uygulaması oluşturun.
```
npm init -y
```
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ğlanma

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

Microsoft Entra kullanarak NoSQL hesabına yönelik API'nize bağlanmak için bir güvenlik sorumlusu 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 sorumlusu
Azure	Yönetilen kimlik
Azure dışındaki sunucular veya istemciler	Hizmet sorumlusu

Ithalat @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.

komutunu kullanarak @azure/identity npm paketini içeri aktarınnpm install.
```
npm install @azure/identity
```

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

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

Varsayılan kimlik bilgisi uygulamasıyla CosmosClient oluşturma

Yerel bir makinede test ediyorsanız veya uygulamanız yönetilen kimlikler için doğrudan destekle Azure hizmetlerinde çalışacaksa bir örnek oluşturarak OAuth DefaultAzureCredential belirteci alın. Ardından ortam değişkeni ve TokenCredential nesnesini parametre olarak kullanarak CosmosClient sınıfının COSMOS_ENDPOINT 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ı derleme

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ı için API.
Hesabınızdaki kapsayıcıları düzenleyen veritabanları.
Veritabanınızdaki tek tek öğeler kümesini içeren kapsayıcılar.
Kapsayıcınızdaki bir JSON belgesini temsil eden öğeler.

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

Hesaplar, veritabanları, kapsayıcılar ve öğeler dahil olmak üzere Azure Cosmos DB hiyerarşisinin diyagramı.

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:

Sınıf	Açıklama
`CosmosClient`	Bu sınıf, Azure Cosmos DB hizmeti için istemci tarafı mantıksal gösterimi 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 ona karşı 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 başvurudur. Kapsayıcıyla çalışmaya çalıştığınızda sunucu tarafı doğrulanır.

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

Kılavuz	Açıklama
Veritabanı oluşturma	Veritabanları oluşturma
Kapsayıcı oluşturma	Kapsayıcılar oluşturun
Öğe oluşturma ve okuma	Belirli bir öğeyi nokta okuma
Sorgu öğeleri	Birden çok öğeyi sorgulama

Ayrıca bkz.

Sonraki adımlar

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

Aracılığıyla paylaş