hızlı başlangıç: Azure portal bir Azure Cosmos hesabı, veritabanı, kapsayıcı ve öğe oluşturun

UYGULANDıĞı YER: SQL API

Azure Cosmos DB, Microsoft'un genel olarak dağıtılmış çok modelli veritabanı hizmetidir. Azure Cosmos DB, bir bütün olarak genel dağıtım ve yatay Azure Cosmos DB ölçek özelliğinden yararlanan anahtar/değer veritabanlarını, belge veritabanlarını ve grafik veritabanlarını hızlıca oluşturmak ve sorgulamak için kullanabilirsiniz.

bu hızlı başlangıçta, bir Azure Cosmos DB SQL apı hesabı oluşturmak, bir belge veritabanı ve kapsayıcı oluşturmak ve kapsayıcıya veri eklemek için Azure portal nasıl kullanılacağı gösterilmektedir.

Önkoşullar

bir Azure aboneliği veya ücretsiz Azure Cosmos DB deneme hesabı

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

• Azure aboneliği olmadan ücretsiz olarak Azure Cosmos DB deneyebilir , ücretsiz olarak ücretsiz bir katman hesabı oluşturabilirsiniz veya Ilk 400 ru/sn ve 5 GB depolama alanı ücretsiz olarak Azure Cosmos DB ücretsiz bir katman hesabıoluşturabilirsiniz. Azure Cosmos DB öykünücüsünü bir URI ile de kullanabilirsiniz https://localhost:8081 . Öykünücü ile kullanılacak anahtar için bkz. kimlik doğrulama istekleri.

Azure Cosmos DB hesabı oluşturma

1. Kaynak Azure portal veya Giriş sayfasında Kaynak oluştur'a tıklayın.

2. Yeni sayfasında Azure veritabanı için arama Cosmos seçin.

3. Azure veritabanı Cosmos Oluştur'a tıklayın.

4. Azure Cosmos DB Hesabı Oluştur sayfasında, yeni Azure veritabanı hesabı için temel Cosmos girin.

   Ayar	Değer	Açıklama
   Abonelik	Abonelik adı	Bu Azure Cosmos hesabı için kullanmak istediğiniz Azure aboneliğini seçin.
   Kaynak Grubu	Kaynak grubu adı	Bir kaynak grubu seçin veya Yeni oluştur seçeneğini belirleyin ve yeni kaynak grubu için benzersiz bir ad girin.
   Hesap Adı	Benzersiz bir ad	Azure Cosmos hesabınızı tanımlayan bir ad girin. URI’nizi oluşturmak için sağladığınız ada documents.azure.com ekleneceği için benzersiz bir ad kullanın. Ad yalnızca küçük harf, sayı ve kısa çizgi (-) karakterini içerebilir. 3-44 karakter uzunluğunda olmalıdır.
   API	Oluşturulacak hesap türü	SQL söz dizimini kullanarak belge veritabanı ve sorgusu oluşturmak için Cekirdek (SQL) seçeneğini belirleyin. API, oluşturulacak hesap türünü belirler. Azure Cosmos DB beş API sağlar: Belge verileri için Çekirdek (SQL) ve MongoDB, graf verileri için Gremlin, Azure Tablosu ve Cassandra. Şu anda, her API için farklı bir hesap oluşturmanız gerekir. SQL API’si hakkında daha fazla bilgi edinin.
   Konum	Kullanıcılarınıza en yakın bölge	Azure Cosmos DB hesabınızın barındırılacağı coğrafi konumu seçin. Verilere en hızlı erişimi sağlamak için kullanıcılarınıza en yakın olan konumu kullanın.
   Kapasite modu	Sağlanan aktarım hızı veya Sunucusuz	Sağlanan aktarım hızı modunda bir hesap oluşturmak için Sağlanan aktarım hızı'ı seçin. Sunucusuz modda bir hesap oluşturmak için Sunucusuz'ı seçin.
   Azure Cosmos DB ücretsiz katmanı indirimini uygulama	Uygula veya Uygula	Azure Cosmos DB ücretsiz katmanı ile bir hesapta ilk 1000 RU/sn ve 25 GB depolama alanı ücretsiz olarak elde edilir. Ücretsiz katman hakkında daha fazla bilgi.

   Not

   Azure aboneliği başına en fazla bir ücretsiz katman azure Cosmos DB hesabınız olabilir ve hesabı oluştururken kabul etmek zorundasınız. Ücretsiz katman indirimi uygulama seçeneğini görmüyorsanız, bu abonelikte başka bir hesabın ücretsiz katmanla zaten etkinleştirilmiştir.

   

5. Genel Dağıtım sekmesinde aşağıdaki ayrıntıları yapılandırabilirsiniz. Bu hızlı başlangıç için varsayılan değerleri bırakın:

   Ayar	Değer	Açıklama
   Coğrafi Yedeklilik	Devre Dışı Bırak	Bölgenizi bir çift bölgeyle eşleştirerek hesabınız üzerinde genel dağıtımı etkinleştirin veya devre dışı bırakma. Hesabınıza daha sonra daha fazla bölge ekebilirsiniz.
   Birden Çok Bölgeli Yazmalar	Devre Dışı Bırak	Çok bölgeli yazma özelliği, dünya genelindeki veritabanlarınız ve kapsayıcılar için sağlanan aktarım hızından yararlanmanızı sağlar.

   Not

   Kapasite modu olarak Sunucusuz seçeneğini belirtirsanız aşağıdaki seçenekler kullanılamaz:

   • Ücretsiz Katman İndirimi Uygula
   • Coğrafi yedeklilik
   • Birden Çok Bölgeli Yazmalar

6. İsteğe bağlı olarak, aşağıdaki sekmelerde ek ayrıntıları yapılandırabilirsiniz:

   • Ağ - Sanal ağdan erişimi yapılandırma.
   • Yedekleme İlkesi - Düzenli veya sürekli yedekleme ilkesi yapılandırma.
   • Şifreleme - Hizmet tarafından yönetilen anahtarı veya müşteri tarafından yönetilen anahtarı kullanın.
   • Etiketler- Etiketler, kaynakları kategorilere ayırmayı ve aynı etiketi birden çok kaynağa ve kaynak gruplarına uygulayarak birleştirilmiş faturalamayı görüntülemenizi sağlayan ad/değer çiftleridir.

7. Gözden geçir ve oluştur’u seçin.

8. Hesap ayarlarını gözden geçirip Oluştur seçeneğini belirleyin. Hesabın oluşturulması birkaç dakika sürer. Portal sayfasında Dağıtımınız tamamlandı iletisinin görüntülenmesini bekleyin.

   

9. Azure Cosmos DB hesabı sayfasına gitmek için Kaynağa git seçeneğini belirleyin.

   

Veritabanı ve kapsayıcı ekleme

Veritabanı ve kapsayıcı oluşturmak için Azure portal Veri Gezgini kullanabilirsiniz.

1. Azure Cosmos DB hesabı sayfanızda sol gezinti Veri Gezgini seçin ve ardından yeni kapsayıcı' yı seçin.

   Kapsayıcı Ekle penceresini görmek için sağa kaydırmanız gerekebilir.

   

2. Kapsayıcı Ekle bölmesinde, yeni kapsayıcının ayarlarını girin.

   Ayar	Önerilen değer	Açıklama
   Veritabanı Kimliği	ToDoList	Yeni veritabanının adı olarak ToDoList girin. Veritabanı adları 1 ila 255 karakterden oluşmalıdır ve /, \\, #, ? boşluk içeremez veya sonunda boşluk olamaz. Kapsayıcılar arasında iş aktarımını paylaşma seçeneğinde, veritabanında sağlanan aktarım hızını veritabanı içindeki tüm kapsayıcılar arasında paylaşmanıza olanak sağlar. Bu seçenek maliyet tasarruflarıyla de yardımcı olur.
   Veritabanı performansı	Otomatik ölçeklendirme veya el ile üretilen iş sağlama sağlayabilirsiniz. El ile üretilen iş, RU/s 'yi kendi kendinize ölçeklendirmenize olanak tanırken otomatik ölçeklendirme verimi, sistemin kullanıma göre RU/s ölçeklenmesi sağlar. Bu örnek için el ile ' yi seçin. Aktarım hızını saniyede 400 istek birimi (RU/s) olarak bırakın. Gecikme süresini azaltmak isterseniz, Kapasite hesaplayıcıyagereken ru/s 'yi tahmin ederek üretilen işi daha sonra ölçeklendirebilirsiniz. Not: Bu ayar, sunucusuz hesapta yeni bir kapsayıcı oluşturulurken kullanılamaz.
   Kapsayıcı Kimliği	Öğeler	Öğeleri yeni kapsayıcının adı olarak girin. Kapsayıcı kimliklerinin karakter gereksinimleri, veritabanı adlarına ilişkin karakter gereksinimleri ile aynıdır.
   Bölüm anahtarı	/kategori	Bu makalede açıklanan örnek, bölüm anahtarı olarak /category kullanır.

   Bu örnek için benzersiz anahtarlar eklemeyin veya analitik depoyu etkinleştirin. Benzersiz anahtarlar, bölüm anahtarı başına bir veya daha fazla değerin benzersizliğini sağlayarak veritabanına veri bütünlüğü katmanı eklemenizi sağlar. daha fazla bilgi için bkz . Azure Cosmos DB içindeki benzersiz anahtarlar. Analitik depo , işlemsel iş yüklerinize herhangi bir etkisi olmadan işlemsel verilere karşı büyük ölçekli analizler sağlamak için kullanılır.

3. Tamam’ı seçin. Veri Gezgini yeni veritabanını ve oluşturduğunuz kapsayıcıyı görüntüler.

Veritabanınıza veri ekleme

Veri Gezgini kullanarak yeni veritabanınıza veri ekleyin.

1. Veri Gezgini' de, ToDoList veritabanını genişletin ve öğeler kapsayıcısını genişletin. Sonra, öğeler' i ve sonra Yeni öğe' yi seçin.

   

2. Belgeler bölmesinin sağ tarafındaki belgeye aşağıdaki yapıyı ekleyin:

   {
       "id": "1",
       "category": "personal",
       "name": "groceries",
       "description": "Pick up apples and strawberries.",
       "isComplete": false
   }
   

3. Kaydet’i seçin.

   

4. Yeni belge ' yi yeniden seçin ve benzersiz id ve istediğiniz diğer özellikleri ve değerleri içeren başka bir belge oluşturun ve kaydedin. Azure Cosmos DB verileriniz üzerinde herhangi bir şema uygulamayan, belgeleriniz herhangi bir yapıya sahip olabilir.

Verilerinizi sorgulayın

Verilerinizi almak ve filtrelemek Veri Gezgini sorgular kullanabilirsiniz.

1. Dosyanın Öğeler sekmesinin üst kısmında Veri Gezgini sorgusunu gözden SELECT * FROM c geçirebilirsiniz. Bu sorgu, kapsayıcıdan kimlikle sıra edilen tüm belgeleri alın ve görüntüler.

   

2. Sorguyu değiştirmek için Filtreyi Düzenle'yi seçin, varsayılan sorguyu ile değiştirin ORDER BY c._ts DESC ve ardından Filtre Uygula'ya tıklayın.

   

   Değiştirilen sorgu, belgeleri zaman damgalarına göre azalan düzende görüntüler, bu nedenle şimdi ilk olarak ikinci belgeniz listelenir.

   

SQL söz dizimi hakkında bilgi sahibiysiniz, sorgu önkatesi kutusuna desteklenen tüm SQL sorgularını girebilirsiniz. Sunucu tarafı iş mantığı Veri Gezgini saklı yordamlar, UFS'ler ve tetikleyiciler oluşturmak için de bu yordamları kullanabilirsiniz.

Veri Gezgini API'lerde Azure portal yerleşik programlı veri erişimi özelliklerine kolay erişim ve erişim sağlar. Ayrıca aktarım hızını ölçeklendirmek, anahtarları ve bağlantı dizelerini almak ve hesap hesabınız için ölçümleri ve SLA'Azure Cosmos DB kullanırsınız.

Kaynakları temizleme

Uygulama ve hesap hesabınızla Azure Cosmos DB, daha fazla ücret ödemeden oluşturduğunuz Azure kaynaklarını silebilirsiniz. Kaynakları silmek için:

1. Arama Azure portal kaynak grupları için arama ve seçimlerini kullanın.

2. Listeden bu hızlı başlangıç için oluşturduğunuz kaynak grubunu seçin.

   

3. Kaynak grubunun Genel Bakış sayfasında Kaynak grubunu sil'i seçin.

   

4. Sonraki pencerede, silinecek kaynak grubunun adını girin ve Sil'i seçin.

yalnızca veritabanını silmek ve gelecekte Azure Cosmos hesabını kullanmak istiyorsanız, aşağıdaki adımlarla veritabanını silebilirsiniz:

• Azure Cosmos hesabınıza alındı.
• Veri Gezgini açın, silmek istediğiniz veritabanına sağ tıklayın ve veritabanını sil' i seçin.
• Silme işlemini onaylamak için veritabanı KIMLIĞI/veritabanı adını girin.

Sonraki adımlar

bu hızlı başlangıçta, Veri Gezgini kullanarak bir Azure Cosmos DB hesabı oluşturmayı, veritabanı ve kapsayıcı oluşturmayı öğrendiniz. Şimdi Azure Cosmos DB hesabınıza ek veriler aktarabilirsiniz.

Azure Cosmos DB bir geçişe yönelik kapasite planlaması yapılmaya çalışılıyor musunuz? Kapasite planlaması için mevcut veritabanı kümeniz hakkında bilgi kullanabilirsiniz.

• Varsa, var olan veritabanı kümenizdeki sanal çekirdek ve sunucu sayısı varsa, sanal çekirdekler veya vCPU 'lar kullanarak istek birimlerini tahmin etme hakkında bilgi edinin
• geçerli veritabanı iş yükünüz için tipik istek hızlarını biliyorsanız, Azure Cosmos DB kapasite planlayıcısı kullanarak istek birimlerini tahmin etme hakkında bilgi edinin