Rychlý start: Použití Azure DocumentDB s ovladačem MongoDB pro Javu

V tomto rychlém startu vytvoříte základní aplikaci Azure DocumentDB pomocí Javy. Azure DocumentDB je úložiště dat NoSQL, které umožňuje aplikacím ukládat dokumenty v cloudu a přistupovat k nim pomocí oficiálních ovladačů MongoDB. Tento průvodce ukazuje, jak vytvářet dokumenty a provádět základní úlohy v clusteru Azure DocumentDB pomocí Javy.

Referenční informace k | rozhraní APIZdrojový kód | Balíček (Maven)

Požadavky

Předplatné Azure
- Pokud ještě předplatné Azure nemáte, vytvořte si bezplatný účet.

Java 21 nebo novější

Vytvoření clusteru Azure DocumentDB

Abyste mohli začít, musíte nejprve vytvořit cluster Azure DocumentDB, který slouží jako základ pro ukládání a správu dat NoSQL.

Přihlaste se k webu Azure Portal (https://portal.azure.com).
V nabídce webu Azure Portal nebo na domovské stránce vyberte Vytvořit prostředek.
Na stránce Nový vyhledejte a vyberte Azure DocumentDB.
Na stránce Vytvořit cluster Azure DocumentDB a v části Základy vyberte možnost Konfigurovat v části Vrstva clusteru .
Na stránce Škálování nakonfigurujte tyto možnosti a pak výběrem možnosti Uložit uložte změny na úrovni clusteru.

Hodnota

Úroveň clusteru M30 tier, 2 vCore, 8-GiB RAM

Úložiště pro shard 128 GiB

	Hodnota
Úroveň clusteru	`M30 tier, 2 vCore, 8-GiB RAM`
Úložiště pro shard	`128 GiB`

Zpět v části Základy nakonfigurujte následující možnosti:

	Hodnota
Subscription	Výběr předplatného Azure
Skupina zdrojů	Vytvoření nové skupiny prostředků nebo výběr existující skupiny prostředků
Název clusteru	Zadejte globálně jedinečný název.
Location	Vyberte podporovanou oblast Azure pro vaše předplatné.
Verze MongoDB	Vyberte `8.0`
Uživatelské jméno správce	Vytvoření uživatelského jména pro přístup ke clusteru jako správce uživatele
Heslo	Použití jedinečného hesla přidruženého k uživatelskému jménu

Snímek obrazovky zobrazující parametry clusteru

Návod

Poznamenejte si hodnoty, které používáte pro uživatelské jméno a heslo. Tyto hodnoty se používají dále v tomto průvodci. Další informace o platných hodnotách najdete v tématu Omezení clusteru.

Vyberte Další: Sítě.
V části Pravidla brány firewall na kartě Sítě nakonfigurujte tyto možnosti:

Hodnota

Metoda připojení Public access

Povolit veřejný přístup ze služeb a prostředků Azure v rámci Azure k tomuto clusteru Enabled
Přidáním pravidla brány firewall pro aktuální klientské zařízení udělte přístup ke clusteru výběrem + Přidat aktuální IP adresu klienta.

Návod

V mnoha podnikových prostředích jsou IP adresy vývojářských počítačů skryté kvůli nastavení sítě VPN nebo jiné podnikové sítě. V těchto případech můžete dočasně povolit přístup ke všem IP adresám přidáním rozsahu 0.0.0.0 - 255.255.255.255 IP adres jako pravidla brány firewall. Toto pravidlo brány firewall používejte pouze dočasně jako součást testování a vývoje připojení.
Vyberte možnost Zkontrolovat a vytvořit.
Zkontrolujte nastavení, která zadáte, a pak vyberte Vytvořit. Vytvoření clusteru bude trvat několik minut. Počkejte na dokončení nasazení prostředků.
Nakonec vyberte Přejít k prostředku a přejděte na cluster Azure DocumentDB v portálu.

	Hodnota
Metoda připojení	`Public access`
Povolit veřejný přístup ze služeb a prostředků Azure v rámci Azure k tomuto clusteru	Enabled

Snímek obrazovky znázorňující možnosti prostředku goto

Získání přihlašovacích údajů clusteru

Získejte přihlašovací údaje, které používáte pro připojení ke clusteru.

Na stránce clusteru vyberte v nabídce prostředků možnost Připojovací řetězce .
V části Připojovací řetězce zkopírujte nebo poznamenejte hodnotu z pole Připojovací řetězec .

Snímek obrazovky znázorňující možnost připojovacích řetězců

Důležité

Připojovací řetězec na portálu neobsahuje hodnotu hesla. Zástupný symbol musíte nahradit <password> přihlašovacími údaji, které jste zadali při vytváření clusteru, nebo interaktivně zadat heslo.

Inicializace projektu

V aktuálním adresáři vytvořte nový projekt Maven.

Začněte v prázdném adresáři.
Otevřete terminál v aktuálním adresáři.

Vytvořte nový projekt Maven pomocí archetypu rychlého startu.

mvn archetype:generate -DgroupId=com.example -DartifactId=azure-documentdb-java-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

Přejděte do vygenerovaného adresáře projektu.
```
cd azure-documentdb-java-quickstart
```
Sestavte projekt, abyste zajistili, že byl úspěšně vytvořen.
```
mvn compile
```

Instalace klientské knihovny

Klientská knihovna je jako artefakt mongodb-driver-sync dostupná prostřednictvím Mavenu.

Do souboru pom.xml přidejte závislost ovladače MongoDB Java.

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-sync</artifactId>
    <version>5.2.0</version>
</dependency>

Otevřete a zkontrolujte soubor pom.xml a ověřte, že položka závislosti existuje.

Naimportujte požadované balíčky do kódu aplikace:

import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.ReplaceOptions;
import org.bson.Document;
import org.bson.conversions.Bson;

import java.util.Arrays;
import java.util.List;

Objektový model

Název	Description
`MongoClient`	Typ použitý pro připojení k MongoDB.
`MongoDatabase`	Představuje databázi v clusteru.
`MongoCollection<Document>`	Představuje kolekci v rámci databáze v clusteru.

Kód v této aplikaci se připojí k databázi pojmenované adventureworks a kolekci s názvem products. Kolekce products obsahuje podrobnosti, jako je název, kategorie, množství, jedinečný identifikátor a příznak prodeje pro každý produkt. Zde uvedené ukázky kódu provádějí nejběžnější operace při práci s kolekcí.

Ověření klienta

Nejprve se připojte k klientovi pomocí základního připojovacího řetězce.

Vytvořte hlavní metodu a nastavte připojovací řetězec. Nahraďte <your-cluster-name>, <your-username> a <your-password> vašimi skutečnými informacemi o clusteru.

public class App {
    public static void main(String[] args) {
        // Connection string for Azure DocumentDB cluster
        String connectionString = "mongodb+srv://<your-username>:<your-password>@<your-cluster-name>.global.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000";

Vytvořte klienta MongoDB a ověřte připojení.

        // Create a new client and connect to the server
        try (MongoClient mongoClient = MongoClients.create(connectionString)) {

            // Ping the server to verify connection
            MongoDatabase database = mongoClient.getDatabase("admin");
            database.runCommand(new Document("ping", 1));

            System.out.println("Successfully connected and pinged Azure DocumentDB");

Získání kolekce

Teď získejte databázi a kolekci. Pokud databáze a kolekce ještě neexistují, pomocí ovladače ji vytvořte automaticky.

Získejte odkaz na databázi.

            // Get database reference
            MongoDatabase adventureWorksDatabase = mongoClient.getDatabase("adventureworks");
            System.out.println("Connected to database: " + adventureWorksDatabase.getName());

Získejte odkaz na kolekci v databázi.

            // Get collection reference
            MongoCollection<Document> productsCollection = adventureWorksDatabase.getCollection("products");
            System.out.println("Connected to collection: products");

Vytvoření dokumentu

Pak v kolekci vytvořte několik nových dokumentů. Vložte dokumenty, aby se zajistilo, že nahradí všechny existující dokumenty, pokud již existují se stejným jedinečným identifikátorem.

Vytvoření ukázkových dokumentů produktu pomocí třídy Document

            // Create sample products
            List<Document> products = Arrays.asList(
                new Document("_id", "00000000-0000-0000-0000-000000004018")
                    .append("name", "Windry Mittens")
                    .append("category", "apparel-accessories-gloves-and-mittens")
                    .append("quantity", 121)
                    .append("price", 35.00)
                    .append("sale", false),
                new Document("_id", "00000000-0000-0000-0000-000000004318")
                    .append("name", "Niborio Tent")
                    .append("category", "gear-camp-tents")
                    .append("quantity", 140)
                    .append("price", 420.00)
                    .append("sale", true)
            );

Vložte dokumenty pomocí operací upsert.

            // Insert documents with upsert
            for (Document product : products) {
                Bson filter = Filters.eq("_id", product.getString("_id"));
                ReplaceOptions options = new ReplaceOptions().upsert(true);

                productsCollection.replaceOne(filter, product, options);
                System.out.println("Upserted product: " + product.getString("name"));
            }

Načtení dokumentu

Dále proveďte operaci čtení bodu, která načte konkrétní dokument z kolekce.

Definujte filtr pro vyhledání konkrétního dokumentu podle ID.

            // Retrieve a specific document by ID
            Bson filter = Filters.eq("_id", "00000000-0000-0000-0000-000000004018");

Spusťte dotaz a načtěte výsledek.

            Document retrievedProduct = productsCollection.find(filter).first();

            if (retrievedProduct != null) {
                System.out.println("Retrieved product: " + retrievedProduct.getString("name") + 
                                 " - $" + retrievedProduct.getDouble("price"));
            } else {
                System.out.println("Product not found");
            }

Dotazování na dokumenty

Nakonec dotazujte více dokumentů pomocí dotazovacího jazyka MongoDB (MQL).

Definujte dotaz pro vyhledání dokumentů odpovídajících konkrétním kritériím.

            // Query for products on sale
            Bson saleFilter = Filters.eq("sale", true);

Iterujte kurzorem a získejte všechny odpovídající dokumenty.

            System.out.println("Products on sale:");
            for (Document product : productsCollection.find(saleFilter)) {
                System.out.printf("- %s: $%.2f (Category: %s)%n",
                    product.getString("name"),
                    product.getDouble("price"),
                    product.getString("category"));
            }

        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Prozkoumání dat pomocí editoru Visual Studio Code

Pomocí rozšíření DocumentDB v editoru Visual Studio Code můžete provádět základní databázové operace, včetně dotazování, vkládání, aktualizace a odstraňování dat.

Otevřete Visual Studio Code.
Přejděte do zobrazení Rozšíření a vyhledejte termín DocumentDB. Vyhledejte rozšíření DocumentDB pro VS Code.
Vyberte tlačítko Instalovat pro rozšíření. Počkejte na dokončení instalace. Pokud se zobrazí výzva, znovu načtěte Visual Studio Code.
Výběrem odpovídající ikony na panelu aktivit přejděte na rozšíření DocumentDB .
V podokně Připojení DocumentDB vyberte + Nové připojení....
V dialogovém okně vyberte Zjišťování služeb a pak Azure DocumentDB – Azure Service Discovery.
Vyberte své předplatné Azure a nově vytvořený cluster Azure DocumentDB.

Návod

V mnoha podnikových prostředích jsou IP adresy vývojářských počítačů skryté kvůli nastavení sítě VPN nebo jiné podnikové sítě. V těchto případech můžete dočasně povolit přístup ke všem IP adresám přidáním rozsahu 0.0.0.0 - 255.255.255.255 IP adres jako pravidla brány firewall. Toto pravidlo brány firewall používejte pouze dočasně jako součást testování a vývoje připojení. Další informace najdete v tématu konfigurace brány firewall.
V podokně Připojení DocumentDB najděte uzel vašeho clusteru a rozbalte jej, poté přejděte k vašim existujícím uzlům dokumentů a kolekcí.
Otevřete místní nabídku kolekce a pak vyberte DocumentDB Scrapbook<0/> Nový DocumentDB Scrapbook.
Zadejte následující příkazy jazyka MongoDB Query Language (MQL) a pak vyberte Spustit vše. Sledujte výstup z příkazů.
```
db.products.find({
  price: { $gt: 200 },
  sale: true
})
.sort({ price: -1 })
.limit(3)
```

Vyčistěte zdroje

Až budete hotovi s clusterem Azure DocumentDB, můžete odstranit prostředky Azure, které jste vytvořili, takže vám nebudou účtovány další poplatky.

Na panelu hledání na webu Azure Portal vyhledejte a vyberte skupiny prostředků.
V seznamu vyberte skupinu prostředků, kterou jste použili pro účely tohoto rychlého startu.
Na stránce skupiny prostředků vyberte Odstranit skupinu prostředků.
V potvrzovací dialogovém okně odstranění zadejte název skupiny prostředků, abyste potvrdili, že ji chcete odstranit. Nakonec vyberte Odstranit a trvale odstraňte skupinu prostředků.

Co je Azure DocumentDB?

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-11-19