Sdílet prostřednictvím

Rychlý start: Použití služby Azure Cosmos DB pro MongoDB (RU) s .NET

  • Článek
  • Platí pro:
    ✅ MongoDB (RU)

V tomto rychlém startu nasadíte základní aplikaci Azure Cosmos DB pro MongoDB pomocí Pythonu. Azure Cosmos DB pro MongoDB je úložiště dat bez schématu, které umožňuje aplikacím ukládat nestrukturované dokumenty v cloudu s knihovnami MongoDB. Naučíte se vytvářet dokumenty a provádět základní úlohy v rámci prostředku služby Azure Cosmos DB pomocí Pythonu.

Balíček zdrojového kódu | knihovny (NuGet) | Azure Developer CLI

Požadavky

  • Azure Developer CLI
  • Docker Desktop
  • .NET SDK 9.0

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 Table 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-mongodb-dotnet-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.

Snímek obrazovky se spuštěnou webovou aplikací

Instalace klientské knihovny

Klientská knihovna je k dispozici prostřednictvím Balíčku NuGet MongoDB.Driver .

  1. Otevřete terminál a přejděte do /src/web složky.

    cd ./src/web

  2. Pokud ještě není nainstalovaný, nainstalujte MongoDB.Driver balíček pomocí dotnet add package.

    dotnet add package MongoDB.Driver

  3. Otevřete a zkontrolujte soubor src/web/Microsoft.Samples.Cosmos.MongoDB.Quickstart.Web.csproj a ověřte, že položka MongoDB.Driver existuje.

Objektový model

Název Popis
MongoClient Typ použitý pro připojení k MongoDB.
Database Představuje databázi v účtu.
Collection Představuje kolekci v databázi v účtu.

Příklady kódu

Vzorový kód v šabloně používá databázi s názvem cosmicworks a kolekcí s názvem products. Kolekce products obsahuje podrobnosti, jako je název, kategorie, množství a jedinečný identifikátor každého produktu. Kolekce používá /category vlastnost jako klíč horizontálního dělení.

Ověření klienta

Tato ukázka vytvoří novou instanci MongoClient třídy.

string connectionString = "<azure-cosmos-db-for-mongodb-connection-string>";

MongoClient client = new(connectionString);

Získání databáze

Tato ukázka vytvoří instanci IMongoDatabase rozhraní pomocí GetDatabase metody MongoClient třídy.

IMongoDatabase database = client.GetDatabase("<database-name>");

Získání kolekce

Tato ukázka vytvoří instanci obecného IMongoCollection<> rozhraní pomocí GetCollection<> obecné metody IMongoDatabase rozhraní. Obecné rozhraní i metoda používají typ definovaný Product v jiné třídě.

IMongoCollection<Product> collection = database.GetCollection<Product>("<collection-name>");

public record Product(
    string id,
    string category,
    string name,
    int quantity,
    decimal price,
    bool clearance
);

Vytvoření dokumentu

Vytvořte dokument v kolekci pomocí collection.ReplaceOneAsync<> parametru obecného Product typu. Tato metoda "upserts" položku účinně nahradí položku, pokud již existuje.

Product document = new(
    id: "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    category: "gear-surf-surfboards",
    name: "Yamba Surfboard",
    quantity: 12,
    price: 850.00m,
    clearance: false
);

await collection.ReplaceOneAsync<Product>(
    d => d.id == document.id,
    document,
    new ReplaceOptions { IsUpsert = true }
);

Čtení dokumentu

Proveďte operaci čtení bodu pomocí pole jedinečného identifikátoru (id) i klíče horizontálního dělení. Použije se collection.FindAsync<> s parametrem obecného Product typu k efektivnímu načtení konkrétní položky.

IAsyncCursor<Product> documents = await collection.FindAsync<Product>(
    d => d.id == "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" && d.category == "gear-surf-surfboards"
);

Product? document = await documents.SingleOrDefaultAsync();

Dotazování na dokumenty

Pomocí jazyka integrovaného dotazu (LINQ) proveďte dotaz na více položek v kontejneru collection.AsQueryable() . Tento dotaz najde všechny položky v zadané kategorii (klíč horizontálního dělení).

IQueryable<Product> documents = collection.AsQueryable().Where(
    d => d.category == "gear-surf-surfboards"
);

foreach (Product document in await documents.ToListAsync())
{
    // Do something with each item
}

Prozkoumání dat

Prozkoumejte data MongoDB pomocí rozšíření Visual Studio Code pro službu Azure Cosmos DB. Můžete provádět základní databázové operace, mezi které patří mimo jiné:

  • Provádění dotazů pomocí knihy výstřižků nebo editoru dotazů
  • Úpravy, aktualizace, vytváření a odstraňování dokumentů
  • Import hromadných dat z jiných zdrojů
  • Správa databází a kolekcí

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

Vyčiště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