Sdílet prostřednictvím


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

Tento článek ukazuje vytvoření ukázkové aplikace, která používá Spring Data k ukládání a načítání informací pomocí služby Azure Cosmos DB pro Apache Cassandra.

Požadavky

  • Klient Git

  • 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 služby Azure Cosmos DB pomocí webu Azure Portal

Poznámka:

Podrobnější informace o vytváření účtů najdete v dokumentaci ke službě Azure Cosmos DB.

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

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

  3. Na obrazovce vybrat rozhraní API vyberte Cassandra.

    Azure Portal, vytvořte prostředek, vyberte možnost rozhraní API, vybranou možnost Cassandra.

  4. Zadejte tyto informace:

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

    Zadejte nastavení účtu služby Azure Cosmos DB.

  5. Po zadání všech výše uvedených informací klikněte na Zkontrolovat a vytvořit.

  6. Pokud na stránce Kontrola vypadá vše správně, klikněte na Vytvořit.

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

Přidání prostoru klíčů do účtu služby Azure Cosmos DB

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

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

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

    Vyberte nový prostor klíčů.

    Vytvořte prostor klíčů služby Azure Cosmos DB.

Načtení nastavení připojení pro váš účet služby Azure Cosmos DB

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

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

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

    Načtěte nastavení připojení ke službě Azure Cosmos DB.

Konfigurace ukázkové aplikace

Následujícím postupem se nakonfiguruje testovací aplikace.

  1. Otevřete příkazové prostředí a naklonujte ukázkový projekt pomocí příkazu git, který se bude podobat následujícímu 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 do něj nebo v něm nakonfigurujte následující řádky, přičemž nahraďte ukázkové hodnoty odpovídajícími hodnotami z předchozího postupu:

    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 z dřívější části tohoto článku.
    spring.data.cassandra.port Určuje Port z dřívější části tohoto článku.
    spring.data.cassandra.username Určuje vaše Uživatelské jméno z dřívější části tohoto článku.
    spring.data.cassandra.password Určuje vaše Primární heslo z dřívější části tohoto č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. Sestavte ukázkovou aplikaci 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 zadáním curl na příkazovém řádku jako v následujících příkladech:

    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 zadáním curl na příkazovém řádku jako v následujících příkladech:

    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 aplikaci Java, která používá Spring Data k ukládání a načítání informací pomocí služby Azure Cosmos DB pro Apache Cassandra.

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

Až už je nebudete potřebovat, odstraňte na webu Azure Portal prostředky vytvořené v tomto článku, aby se vám neúčtovaly poplatky.

Další kroky

Pokud se chcete dozvědět více o architektuře Spring a Azure, přejděte do centra dokumentace Spring v Azure.

Viz také

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