Apache Cassandra için Azure Cosmos DB ile Spring Data kullanma

Bu makalede Apache Cassandraiçin Azure Cosmos DB kullanarak bilgileri depolamak ve almak için Spring Data kullanan örnek bir uygulama oluşturma gösterilmektedir.

Önkoşullar

• Azure aboneliği - ücretsiz bir tane oluşturun.

• Java Development Kit (JDK), sürüm 8 veya üzeri.

• Apache Maven.

• Azure CLI.

• Git istemcisi.

• Fonksiyonu test etmek için cURL veya benzer bir HTTP yardımcı programı.

Azure Cosmos DB hesabı oluşturma

Aşağıdaki prosedür, Azure portalında bir Azure Cosmos DB hesabı oluşturur ve yapılandırır.

Azure portalını kullanarak Azure Cosmos DB hesabı oluşturma

Not

Hesap oluşturma hakkında daha ayrıntılı bilgileriAzure Cosmos DB belgelerinde okuyabilirsiniz.

1. https://portal.azure.com/'da Azure portalına göz atın ve oturum açın.

2. Bir kaynakoluştur'u seçin, sonra başlamak içinve ardından Azure Cosmos DB'yiseçin.

3. API Seç seçeneği ekranında Cassandraöğesini seçin.

   Azure portalı

4. Aşağıdaki bilgileri belirtin:

   • abonelik: Kullanılacak Azure aboneliğinizi belirtin.
   • Kaynak grubu: Yeni bir kaynak grubu mu oluşturulacağını yoksa var olan bir kaynak grubunu mu seçileceğini belirtin.
   • Hesap adı: Azure Cosmos DB hesabınız için benzersiz bir ad seçin; bu ad, wingtiptoyscassandra.documents.azure.comgibi tam etki alanı adı oluşturmak için kullanılır.
   • API: Bu ders için Cassandra belirtin.
   • Konum: Veritabanınız için en yakın coğrafi bölgeyi belirtin.

   

5. Yukarıdaki bilgilerin tümünü girdiğinizde Gözden geçir + oluşturtıklayın.

6. Gözden geçirme sayfasında her şey doğru görünüyorsa, oluşturtıklayın.

Veritabanının dağıtılması birkaç dakika sürer.

Azure Cosmos DB hesabınıza anahtar alanı ekleme

1. https://portal.azure.com/'da Azure portalına göz atın ve oturum açın.

2. Tüm Kaynaklar'ı seçin, ardından oluşturduğunuzAzure Cosmos DB hesabını seçin.

3. Veri Gezgini seçin, aşağı oku seçin ve Yeni Anahtar Alanı seçin. Keyspace kimliğiniziçin benzersiz bir tanımlayıcı girin, ardından Tamam'ı seçin.

   

   

Azure Cosmos DB hesabınızın bağlantı ayarlarını alma

1. https://portal.azure.com/'da Azure portalına göz atın ve oturum açın.

2. Tüm Kaynaklar'ı seçin, ardından oluşturduğunuzAzure Cosmos DB hesabını seçin.

3. Bağlantı dizelerini seçin ve Kişi Noktası, Bağlantı Noktası, Kullanıcı Adıve birincil parola alanları değerlerini kopyalayın; bu değerleri uygulamanızı daha sonra yapılandırmak için kullanacaksınız.

   

Örnek uygulamayı yapılandırma

Aşağıdaki yordam test uygulamasını yapılandırıyor.

1. Aşağıdaki örnekte olduğu gibi bir git komutu kullanarak bir komut kabuğu açın ve örnek projeyi kopyalayın:

   git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
   

2. Örnek projenin kaynakları dizininde application.properties dosyasını bulun veya henüz yoksa dosyayı oluşturun.

3. application.properties dosyasını bir metin düzenleyicisinde açın, dosyaya aşağıdaki satırları ekleyin veya yapılandırın ve örnek değerleri daha önceki uygun değerlerle değiştirin:

   spring.data.cassandra.contact-points=wingtiptoyscassandra.cassandra.cosmos.azure.com
   spring.data.cassandra.port=10350
   spring.data.cassandra.username=wingtiptoyscassandra
   spring.data.cassandra.password=********
   

   Nerede:

   Parametre	Açıklama
   spring.data.cassandra.contact-points	Bu makalede daha önce belirtilen Temas Noktası belirtir.
   spring.data.cassandra.port	Bu makalenin önceki bölümlerinde belirtilen Bağlantı Noktası'i belirtir.
   spring.data.cassandra.username	Bu makalenin önceki kısımlarında belirtilen Kullanıcı Adını belirtin.
   spring.data.cassandra.password	Bu makalede daha önce belirtilen Birincil Parolanız belirleyin.

4. application.properties dosyasını kaydedin ve kapatın.

Örnek uygulamayı paketleme ve test edin

Uygulamayı derlemek ve test etmek için pom.xml dosyasını içeren dizine göz atın.

1. Maven ile örnek uygulama oluşturma; mesela:

   mvn clean package
   

2. Örnek uygulamayı başlatın; mesela:

   java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
   

3. Aşağıdaki örnekler gibi bir komut isteminden curl kullanarak yeni kayıtlar oluşturun:

   curl -s -d "{\"name\":\"dog\",\"species\":\"canine\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   
   curl -s -d "{\"name\":\"cat\",\"species\":\"feline\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   

   Uygulamanız aşağıdaki örneğe benzer değerler döndürmelidir:

   Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.
   
   Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.
   

4. Aşağıdaki örnekler gibi bir komut isteminden curl kullanarak var olan tüm kayıtları alın:

   curl -s http://localhost:8080/pets
   

   Uygulamanız aşağıdaki örnekler gibi değerler döndürmelidir:

   [{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]
   

Özet

Bu öğreticide, Apache Cassandra için Azure Cosmos DB kullanarak bilgileri depolamak ve almak için Spring Data kullanan örnek bir Java uygulaması oluşturdunuz.

Kaynakları temizleme

Artık gerekmediğinde, beklenmeyen ücretlerden kaçınmak için bu makalede oluşturulan kaynakları silmek için Azure portalı kullanın.

Sonraki adımlar

Spring ve Azure hakkında daha fazla bilgi edinmek için Azure'da Spring belge merkezine geçin.

Azure'da İlkbahar

Ayrıca bkz.

Azure'ı Java ile kullanma hakkında daha fazla bilgi için bkz. Azure Java Geliştiricileri için ve Azure DevOps ve Java ile Çalışma .