Jak používat Spring Data se službou Azure Cosmos DB pro Apache Cassandra

Tento článek ukazuje, jak používat Spring Data s Azure Cosmos DB pro Apache Cassandra k vytvoření ukázkové Java aplikace, která ukládá a načítá data.

Požadavky

• Předplatné Azure – vytvořte si ji zdarma.

• Java Development Kit (JDK), verze 8 nebo vyšší.

• Apache Maven

• Azure CLI.

• Git klient .

• cURL nebo podobný nástroj HTTP pro testování funkčnosti.

Vytvoření účtu služby Azure Cosmos DB

Následující postup vytvoří a nakonfiguruje účet služby Azure Cosmos DB na webu Azure Portal.

Vytvoření účtu Azure Cosmos DB pomocí portálu Azure

Poznámka

Další informace o vytvářeníúčtů Azure Cosmos DB ch

1. Přejděte na web Azure Portal na https://portal.azure.com/ a přihlaste se.

2. Vyberte Vytvořit prostředek, vyberte Začínáme a pak vyberte Azure Cosmos DB.

3. Na obrazovce Vyberte rozhraní API vyberte Cassandra .

   

4. Zadejte následující informace:

   • Předplatné: Zadejte předplatné Azure, které chcete použít.
   • Skupina prostředků: Určete, jestli chcete vytvořit novou skupinu prostředků, nebo zvolit existující skupinu prostředků.
   • Název účtu: Zvolte jedinečný název Azure Cosmos DB účtu. Tento název slouží k vytvoření plně kvalifikovaného názvu domény, například wingtiptoyscassandra.documents.azure.com.
   • rozhraní API: Zadejte Cassandra pro účely tohoto kurzu.
   • Umístění: Zadejte nejbližší geografickou oblast pro vaši databázi.

   

5. Když zadáte všechny předchozí informace, vyberte Zkontrolovat a vytvořit.

6. Pokud všechno na stránce kontroly vypadá správně, vyberte Vytvořit.

Nasazení databáze trvá několik minut.

Přidejte klíčový prostor do účtu Azure Cosmos DB

1. Přejděte na web Azure Portal na https://portal.azure.com/ a přihlaste se.

2. Vyberte Všechny prostředky a pak vyberte účet Azure Cosmos DB, který jste vytvořili.

3. Vyberte Data Explorer, vyberte šipku dolů a vyberte Nový prostor klíčů. Zadejte jedinečný identifikátor id prostoru klíčů a pak vyberte OK.

   

   

Načtení nastavení připojení pro účet Azure Cosmos DB

1. Přejděte na web Azure Portal na https://portal.azure.com/ a přihlaste se.

2. Vyberte Všechny prostředky a pak vyberte účet Azure Cosmos DB, který jste vytvořili.

3. Vyberte Připojovací řetězce a zkopírujte hodnoty polí Kontaktní bod, Port, Uživatelské jméno a Primární heslo . Tyto hodnoty použijete k pozdější konfiguraci aplikace.

   

Konfigurace ukázkové aplikace

Následující postup nakonfiguruje testovací aplikaci.

1. Otevřete příkazové prostředí a naklonujte ukázkový projekt pomocí příkazu Git, například v následujícím příkladu:

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

2. Vyhledejte soubor application.properties v adresáři prostředků ukázkového projektu nebo vytvořte soubor, pokud ještě neexistuje.

3. Otevřete soubor application.properties v textovém editoru a přidejte nebo nakonfigurujte následující řádky v souboru a nahraďte ukázkové hodnoty příslušnými hodnotami z předchozích verzí:

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

   Kde:

   Parametr	Popis
   spring.data.cassandra.contact-points	Určuje kontaktní bod zmíněný dříve v tomto článku.
   spring.data.cassandra.port	Určuje port zmíněný v dřívější části tohoto článku.
   spring.data.cassandra.username	Určuje vaše uživatelské jméno zmíněné dříve v tomto článku.
   spring.data.cassandra.password	Zadejte vaše primární heslo uvedené dříve v tomto článku.

4. Uložte a zavřete soubor application.properties.

Zabalení a otestování ukázkové aplikace

Přejděte do adresáře, který obsahuje soubor pom.xml a sestavte a otestujte aplikaci.

1. Sestavení ukázkové aplikace pomocí Mavenu; například:

   mvn clean package
   

2. Spusťte ukázkovou aplikaci; například:

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

3. Vytvořte nové záznamy pomocí curl příkazového řádku. Následující příklady ukazují, jak vytvořit záznamy:

   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
   

   Aplikace by měla vracet hodnoty jako v následujícím příkladu:

   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. Načtěte všechny existující záznamy pomocí curl příkazového řádku. Následující příklady ukazují, jak načíst záznamy:

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

   Aplikace by měla vracet hodnoty jako v následujících příkladech:

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

Shrnutí

V tomto kurzu jste vytvořili ukázkovou Java aplikaci, která používá Spring Data k ukládání a načítání informací pomocí Azure Cosmos DB pro Apache Cassandra.

Vyčištění prostředků

Pokud už prostředky nepotřebujete, odstraňte je pomocí portálu Azure. Odstraněním prostředků se můžete vyhnout neočekávaným poplatkům.

Další kroky

Další informace o Springu a Azure najdete v centru dokumentace Spring on Azure.

Jaro na Azure

Viz také

Další informace o používání Azure s Javou najdete v Azure pro vývojáře v Javě a Práce s Azure DevOps a javou.