JS için NoSQL SDK'sı için Azure Cosmos DB örnekleri

  • Makale

UYGULANANLAR: NoSQL

Azure Cosmos DB kaynaklarında CRUD işlemleri ve diğer yaygın işlemleri gerçekleştiren örnek çözümler, Azure Cosmos DB github deposu için JavaScript SDK'sı'na dahil edilmiştir. Bu makalede aşağıdakiler sunulmaktadır:

  • Node.js örnek proje dosyalarının her birindeki görevlere bağlantılar.
  • İlgili API başvurusu içeriğine bağlantılar.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Azure Cosmos DB'yi ücretsiz olarak, Azure aboneliği olmadan ve hiçbir taahhüt gerektirmeden deneyebilirsiniz. Alternatif olarak, ilk 1000 RU/sn ve 25 GB depolama alanı ücretsiz olarak bir Azure Cosmos DB ücretsiz katmanı hesabı oluşturabilirsiniz. Azure Cosmos DB öykünücüsünün URI'sini https://localhost:8081de kullanabilirsiniz. Öykünücü ile kullanılacak anahtar için bkz . İsteklerin kimliğini doğrulama.

JavaScript SDK'sına da ihtiyacınız vardır.

Dekont

Örnekler birbirinden bağımsızdır, kendi kendine ayarlanır ve sonra kendini temizler. Böyle olunca, örneklerde birden çok Containers.create çağrısı yapılır. Bu her yapıldığında, oluşturulan kapsayıcının performans katmanı başına aboneliğiniz 1 saatlik kullanım için faturalandırılır.

Veritabanı örnekleri

DatabaseManagement dosyası, veritabanında CRUD işlemlerinin nasıl gerçekleştirileceklerini gösterir. Aşağıdaki örnekleri çalıştırmadan önce Azure Cosmos DB veritabanları hakkında bilgi edinmek için veritabanları, kapsayıcılar ve öğelerle çalışma kavramsal makalesine bakın.

Görev API başvurusu
Yoksa veritabanı oluşturma Databases.createIfNotExists
Hesabın veritabanlarını listeleme Databases.readAll
Kimliğe göre veritabanını okuma Database.read
Veritabanı silme Database.delete

Kapsayıcı örnekleri

ContainerManagement dosyası, kapsayıcıda CRUD işlemlerinin nasıl gerçekleştirileceklerini gösterir. Aşağıdaki örnekleri çalıştırmadan önce Azure Cosmos DB koleksiyonları hakkında bilgi edinmek için veritabanları, kapsayıcılar ve öğelerle çalışma kavramsal makalesine bakın.

Görev API başvurusu
Yoksa kapsayıcı oluşturma Containers.createIfNotExists
Bir hesaptaki kapsayıcıları listeleme Containers.readAll
Kapsayıcı tanımını okuma Container.read
Kapsayıcı silme Container.delete

Öğe örnekleri

ItemManagement dosyası, öğe üzerinde CRUD işlemlerinin nasıl gerçekleştirileceklerini gösterir. Aşağıdaki örnekleri çalıştırmadan önce Azure Cosmos DB belgeleri hakkında bilgi edinmek için veritabanları, kapsayıcılar ve öğelerle çalışma kavramsal makalesine bakın.

Görev API başvurusu
Öğe oluşturma Items.create
Bir kapsayıcıdaki tüm öğeleri okuma Items.readAll
Kimliğe göre öğe okuma Item.read
Yalnızca değişen öğeleri okuma Item.read - RequestOptions.accessCondition
Belgeler için sorgu Items.query
Bir öğeyi değiştirme Item.replace
Koşullu ETag denetimiyle öğeyi değiştirme Item.replace - RequestOptions.accessCondition
Öğeyi silme Item.delete

Dizin örnekleri

IndexManagement dosyası, dizin oluşturmayı yönetmeyi gösterir. Aşağıdaki örnekleri çalıştırmadan önce Azure Cosmos DB'de dizin oluşturma hakkında bilgi edinmek için dizin oluşturma ilkeleri, dizin oluşturma türleri ve dizin oluşturma yolları kavramsal makalelerine bakın.

Görev API başvurusu
Belirli bir öğeyi el ile dizine ekleme RequestOptions.indexingDirective: 'include'
Belirli bir öğeyi dizinden el ile dışlama RequestOptions.indexingDirective: 'exclude'
Yolu dizinin dışında tutma IndexingPolicy.ExcludedPath
Dize yolunda bir aralık dizini oluşturma IndexKind.Range, IndexingPolicy, Items.query
Varsayılan indexPolicy ile bir kapsayıcı oluşturun ve kapsayıcıyı çevrimiçi olarak güncelleştirin Containers.create

Sunucu tarafı programlama örnekleri

index.ts dosyasında aşağıdaki görevlerin nasıl gerçekleştirebileceğiniz gösterilir. Aşağıdaki örnekleri çalıştırmadan önce Azure Cosmos DB'de sunucu tarafı programlama hakkında bilgi edinmek için saklı yordamlar, tetikleyiciler ve kullanıcı tanımlı işlevler kavramsal makalesine bakın.

Görev API başvurusu
Saklı yordam oluşturma StoredProcedures.create
Saklı yordamı yürütme StoredProcedure.execute
Saklı yordamla toplu güncelleştirme StoredProcedure.execute

Sunucu tarafı programlaması hakkında daha fazla bilgi için bkz. Azure Cosmos DB sunucu tarafı programlaması: Saklı yordamlar, veritabanı tetikleyicileri ve UDF'leri.

Azure Identity(AAD) Kimlik Doğrulaması Örnekleri

AADAuth.ts dosyası aşağıdaki görevlerin nasıl gerçekleştirileceklerini gösterir.

Görev API başvurusu
Create credential object from @azure/identity API
Kimlik bilgilerini aadCredentials anahtarıyla istemci nesnesine geçirme API
aad kimlik bilgileriyle cosmos istemcisi yürütme API

Çeşitli örnekler

Aşağıdaki seçilmiş örnekler yaygın senaryoları göstermektedir.

Görev API başvurusu
Sorgu aktarım hızını değiştirme API
Sorgu aktarım hızı alma API
Cosmos DB kaynaklarına kapsamlı erişim vermek için SasTokens kullanma API

Sonraki adımlar

Azure Cosmos DB'ye geçiş için kapasite planlaması yapmaya mı çalışıyorsunuz? Kapasite planlaması için mevcut veritabanı kümeniz hakkındaki bilgileri kullanabilirsiniz.