Szybki start: korzystanie z usługi Azure Cosmos DB dla bazy danych MongoDB za pomocą platformy .NET

• .NET
• Node.js
• Python

W tym szybkim starcie wdrożysz podstawową aplikację Azure Cosmos DB dla MongoDB przy użyciu Pythona. Usługa Azure Cosmos DB dla bazy danych MongoDB to bez schematu magazyn danych, który umożliwia aplikacjom przechowywanie dokumentów bez struktury w chmurze przy użyciu bibliotek MongoDB. Dowiesz się, jak tworzyć dokumenty i wykonywać podstawowe zadania w ramach zasobu usługi Azure Cosmos DB przy użyciu języka Python.

Kod źródłowy biblioteki | Pakiet (NuGet) | Interfejs wiersza polecenia dla deweloperów platformy Azure

Wymagania wstępne

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

Jeśli nie masz jeszcze konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Inicjowanie projektu

Użyj interfejsu wiersza polecenia dla deweloperów platformy Azure (azd), aby utworzyć usługę Azure Cosmos DB dla konta tabeli i wdrożyć konteneryzowaną przykładową aplikację. Przykładowa aplikacja używa biblioteki klienta do zarządzania, tworzenia, odczytywania i wykonywania zapytań dotyczących przykładowych danych.

1. Otwórz terminal w pustym katalogu.

2. Jeśli nie jesteś uwierzytelniony, uwierzytelnij się w Azure Developer CLI przy użyciu polecenia azd auth login. Wykonaj kroki określone przez narzędzie, aby uwierzytelnić się w interfejsie wiersza polecenia przy użyciu preferowanych poświadczeń platformy Azure.

   azd auth login
   

3. Użyj azd init polecenia , aby zainicjować projekt.

   azd init --template cosmos-db-mongodb-dotnet-quickstart
   

4. Podczas inicjowania skonfiguruj unikatową nazwę środowiska.

5. Wdróż konto usługi Azure Cosmos DB przy użyciu polecenia azd up. Szablony Bicep wdrażają również przykładową aplikację internetową.

   azd up
   

6. Podczas procesu aprowizacji wybierz subskrypcję, żądaną lokalizację i docelową grupę zasobów. Poczekaj na zakończenie procesu prowizjonowania. Proces może potrwać około pięciu minut.

7. Po zakończeniu aprowizacji zasobów platformy Azure adres URL uruchomionej aplikacji internetowej zostanie uwzględniony w danych wyjściowych.

   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. Użyj adresu URL w konsoli, aby przejść do aplikacji internetowej w przeglądarce. Obserwuj dane wyjściowe uruchomionej aplikacji.

Instalowanie biblioteki klienta

Biblioteka klienta jest dostępna jako pakiet MongoDB.Driver za pośrednictwem NuGet.

1. Otwórz terminal i przejdź do /src/web folderu.

   cd ./src/web
   

2. Jeśli pakiet nie został jeszcze zainstalowany, zainstaluj go MongoDB.Driver przy użyciu polecenia dotnet add package.

   dotnet add package MongoDB.Driver
   

3. Otwórz i przejrzyj plik src/web/Microsoft.Samples.Cosmos.MongoDB.Quickstart.Web.csproj, aby zweryfikować, czy wpis MongoDB.Driver istnieje.

Importowanie bibliotek

Zaimportuj przestrzeń nazw MongoDB.Driver do kodu swojej aplikacji.

using MongoDB.Driver;

Model obiektów

Nazwa/nazwisko	opis
MongoClient	Typ używany do nawiązywania połączenia z bazą danych MongoDB.
Database	Reprezentuje bazę danych na koncie.
Collection	Reprezentuje kolekcję w bazie danych na koncie.

Przykłady kodu

• Uwierzytelnianie użytkownika
• Pobieranie bazy danych
• Zdobądź kolekcję
• Tworzenie dokumentu
• Pobieranie dokumentu
• Wyszukiwanie w dokumentach

Przykładowy kod w szablonie używa bazy danych o nazwie cosmicworks i kolekcji o nazwie products. Kolekcja products zawiera szczegóły, takie jak nazwa, kategoria, ilość i unikatowy identyfikator dla każdego produktu. Kolekcja używa /category właściwości jako klucza fragmentu.

Uwierzytelnianie użytkownika

Ten przykład tworzy nowe wystąpienie MongoClient klasy.

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

MongoClient client = new(connectionString);

Pobieranie bazy danych

Ten przykład tworzy wystąpienie interfejsu IMongoDatabase używając metody GetDatabase klasy MongoClient.

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

Zdobądź kolekcję

Ten przykład tworzy wystąpienie interfejsu ogólnego IMongoCollection<>, używając ogólnej metody GetCollection<> interfejsu IMongoDatabase. Interfejs ogólny i metoda używają typu zdefiniowanego Product w innej klasie.

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

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

Tworzenie dokumentu

Utwórz dokument w kolekcji, używając collection.ReplaceOneAsync<> z parametrem typu ogólnego Product. Ta metoda skutecznie zastępuje element, jeśli już istnieje, poprzez jego aktualizację lub dodanie.

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 }
);

Odczytywanie dokumentu

Wykonaj operację punktowego odczytu przy użyciu pól unikatowego identyfikatora (id) i klucza fragmentu. Użyj collection.FindAsync<> z parametrem typu ogólnego Product , aby efektywnie pobrać określony element.

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();

Zapytanie o dokumenty

Wykonaj zapytanie względem wielu elementów w kontenerze przy użyciu collection.AsQueryable() i języka zintegrowanego (LINQ). To zapytanie znajduje wszystkie elementy w określonej kategorii (klucz fragmentu).

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

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

Eksplorowanie danych

Użyj rozszerzenia programu Visual Studio Code dla usługi Azure Cosmos DB, aby eksplorować dane bazy danych MongoDB. Możesz wykonywać kluczowe operacje na bazie danych, które obejmują między innymi:

• Wykonywanie zapytań przy użyciu albumu lub edytora zapytań
• Modyfikowanie, aktualizowanie, tworzenie i usuwanie dokumentów
• Importowanie danych zbiorczych z innych źródeł
• Zarządzanie bazami danych i kolekcjami

Aby uzyskać więcej informacji, zobacz How-to use Visual Studio Code extension to explore Azure Cosmos DB for MongoDB data (Jak używać rozszerzenia programu Visual Studio Code do eksplorowania danych usługi Azure Cosmos DB dla bazy danych MongoDB).

Czyszczenie zasobów

Jeśli nie potrzebujesz już przykładowej aplikacji lub zasobów, usuń odpowiednie wdrożenie i wszystkie zasoby.

azd down --force --purge

Powiązana zawartość

• Szybki start Node.js
• Przewodnik Szybki start dla języka Python