Rychlý start: Použití služby Azure Cosmos DB for NoSQL se sadou Azure SDK pro Javu

• .NET
• Node.js
• Java
• Python
• Jít
• Rez

V tomto rychlém startu nasadíte základní aplikaci Azure Cosmos DB for NoSQL pomocí sady Azure SDK pro Javu. Azure Cosmos DB for NoSQL je úložiště dat bez schématu, které umožňuje aplikacím ukládat nestrukturovaná data v cloudu. Dotazování dat v kontejnerech a provádění běžných operací s jednotlivými položkami pomocí sady Azure SDK pro Javu

Referenční dokumentace rozhraní API | Knihovní zdrojový kód | Balíček (Maven) | Azure Developer CLI

Požadavky

• Azure Developer CLI
• Docker Desktop
• Java 21

Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.

Inicializace projektu

Pomocí Azure Developer CLI (azd) vytvořte účet Azure Cosmos DB for NoSQL a nasaďte kontejnerizovanou ukázkovou aplikaci. Ukázková aplikace používá klientskou knihovnu ke správě, vytváření, čtení a dotazování ukázkových dat.

1. Otevřete terminál v prázdném adresáři.

2. Pokud ještě nejste ověřeni, ověřte se v Azure Developer CLI pomocí azd auth login. Postupujte podle kroků určených nástrojem k ověření v rozhraní příkazového řádku pomocí vašich upřednostňovaných přihlašovacích údajů Azure.

   azd auth login
   

3. Slouží azd init k inicializaci projektu.

   azd init --template cosmos-db-nosql-java-quickstart
   

4. Během inicializace nakonfigurujte jedinečný název prostředí.

5. Nasaďte účet služby Azure Cosmos DB pomocí azd up. Šablony Bicep také nasazují ukázkovou webovou aplikaci.

   azd up
   

6. Během procesu zřizování vyberte své předplatné, požadované umístění a cílovou skupinu prostředků. Počkejte na dokončení procesu zřizování. Proces může trvat přibližně pět minut.

7. Po dokončení zřizování prostředků Azure se do výstupu zahrne adresa URL spuštěné webové aplikace.

   Deploying services (azd deploy)
   
     (✓) Done: Deploying service web
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
   

8. Pomocí adresy URL v konzole přejděte do webové aplikace v prohlížeči. Sledujte výstup spuštěné aplikace.

Instalace klientské knihovny

Klientská knihovna je k dispozici prostřednictvím Mavenu azure-spring-data-cosmos jako balíček.

1. Přejděte do /src/web složky a otevřete soubor pom.xml .

2. Pokud ještě neexistuje, přidejte položku balíčku azure-spring-data-cosmos .

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-spring-data-cosmos</artifactId>
   </dependency>
   

3. Přidejte další závislost pro balíček azure-identity, pokud ještě neexistuje.

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
   </dependency>
   

Import knihoven

Naimportujte do kódu aplikace všechny požadované obory názvů.

import com.azure.cosmos.CosmosClientBuilder;
import com.azure.cosmos.models.PartitionKey;
import com.azure.identity.DefaultAzureCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.spring.data.cosmos.config.AbstractCosmosConfiguration;
import com.azure.spring.data.cosmos.config.CosmosConfig;
import com.azure.spring.data.cosmos.core.mapping.Container;
import com.azure.spring.data.cosmos.core.mapping.PartitionKey;
import com.azure.spring.data.cosmos.repository.CosmosRepository;
import com.azure.spring.data.cosmos.repository.Query;
import com.azure.spring.data.cosmos.repository.config.EnableCosmosRepositories;

Objektový model

Název	Popis
EnableCosmosRepositories	Tento typ je dekorátor metody, který slouží ke konfiguraci úložiště pro přístup k databázi Azure Cosmos DB pro NoSQL.
CosmosRepository	Tato třída je primární klientskou třídou a slouží ke správě dat v rámci kontejneru.
CosmosClientBuilder	Tato třída je továrna používaná k vytvoření klienta používaného úložištěm.
Query	Tento typ je dekorátor metody, který slouží k určení dotazu, který vykonává repozitář.

Příklady kódu

• Ověření klienta
• Získání databáze
• Získání kontejneru
• Vytvoření položky
• Získejte položku
• Položky dotazu

Vzorový kód v šabloně používá databázi pojmenovanou cosmicworks a kontejner s názvem products. Kontejner products obsahuje podrobnosti, jako je název, kategorie, množství, jedinečný identifikátor a příznak prodeje pro každý produkt. Kontejner používá /category vlastnost jako logický klíč oddílu.

Ověření klienta

Nejprve tato ukázka vytvoří novou třídu, která dědí z AbstractCosmosConfiguration, aby nakonfigurovala připojení ke službě Azure Cosmos DB pro NoSQL.

@Configuration
@EnableCosmosRepositories
public class CosmosConfiguration extends AbstractCosmosConfiguration {
}

V rámci třídy konfigurace tato ukázka vytvoří novou instanci CosmosClientBuilder třídy a nakonfiguruje ověřování pomocí DefaultAzureCredential instance.

@Bean
public CosmosClientBuilder getCosmosClientBuilder() {
    DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
        .build();
        
    return new CosmosClientBuilder()
        .endpoint("<azure-cosmos-db-nosql-account-endpoint>")
        .credential(credential);
}

Získání databáze

V konfigurační třídě ukázka implementuje metodu pro vrácení názvu existující databáze s názvem cosmicworks.

@Override
protected String getDatabaseName() {
    return "cosmicworks";
}

Získání kontejneru

Pomocí dekorátoru Container metody nakonfigurujte třídu tak, aby reprezentovala položky v kontejneru. Vytvořte třídu tak, aby zahrnovala všechny členy, které chcete serializovat do formátu JSON. V tomto příkladu má typ jedinečný identifikátor a pole pro kategorii, název, množství, cenu a výprodej.

@Container(containerName = "products", autoCreateContainer = false)
public class Item {
    private String id;
    private String name;
    private Integer quantity;
    private Boolean sale;

    @PartitionKey
    private String category;

    // Extra members omitted for brevity
}

Vytvoření položky

Vytvoření položky v kontejneru pomocí repository.save.

Item item = new Item(
    "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "gear-surf-surfboards",
    "Yamba Surfboard",
    12,
    false
);
Item created_item = repository.save(item);

Přečíst položku

Proveďte operaci čtení bodu pomocí polí jedinečného identifikátoru (id) i klíče oddílu. Slouží repository.findById k efektivnímu načtení konkrétní položky.

PartitionKey partitionKey = new PartitionKey("gear-surf-surfboards");
Optional<Item> existing_item = repository.findById("aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", partitionKey);
if (existing_item.isPresent()) {
    // Do something
}

Dotazování položek

Proveďte dotaz na více položek v kontejneru definováním dotazu v rozhraní úložiště. Tato ukázka používá Query dekorátor metody k definování metody, která spouští tento parametrizovaný dotaz:

SELECT * FROM products p WHERE p.category = @category

@Repository
public interface ItemRepository extends CosmosRepository<Item, String> {

    @Query("SELECT * FROM products p WHERE p.category = @category")
    List<Item> getItemsByCategory(@Param("category") String category);

}

Načtěte všechny výsledky dotazu pomocí repository.getItemsByCategory. Projděte výsledky dotazu.

List<Item> items = repository.getItemsByCategory("gear-surf-surfboards");
for (Item item : items) {
    // Do something
}

Prozkoumání dat

K prozkoumání dat NoSQL použijte rozšíření Visual Studio Code pro Azure Cosmos DB. Můžete provádět základní databázové operace, mezi které patří mimo jiné:

• Provádění dotazů pomocí nástroje scrapbook nebo editoru dotazů
• Úpravy, aktualizace, vytváření a odstraňování položek
• Import hromadných dat z jiných zdrojů
• Správa databází a kontejnerů

Další informace najdete v tématu Použití rozšíření Visual Studio Code k prozkoumání Azure Cosmos DB pro NoSQL data.

Uvolnění prostředků

Pokud už ukázkovou aplikaci nebo prostředky nepotřebujete, odeberte odpovídající nasazení a všechny prostředky.

azd down

Související obsah

• Úvod do .NET
• Rychlý start pro Node.js
• Úvod do Javy
• Rychlý start pro Go
• Rychlý start s Rustem