Dela via

Snabbstart: Använda Azure Cosmos DB för MongoDB (RU) med Python

  • Artikel
  • Gäller för:
    ✅ MongoDB (RU)

I den här snabbstarten distribuerar du ett grundläggande Azure Cosmos DB for MongoDB-program med hjälp av Python. Azure Cosmos DB for MongoDB är ett schemalöst datalager som gör att program kan lagra ostrukturerade dokument i molnet med MongoDB-bibliotek. Du lär dig hur du skapar dokument och utför grundläggande uppgifter i din Azure Cosmos DB-resurs med hjälp av Python.

Paket för bibliotekskällkod (PyPI) | Azure Developer CLI |

Förutsättningar

  • Azure Developer CLI
  • Docker Desktop
  • Python 3.12

Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.

Initiera projektet

Använd Azure Developer CLI (azd) för att skapa ett Azure Cosmos DB för tabellkonto och distribuera ett containerbaserat exempelprogram. Exempelprogrammet använder klientbiblioteket för att hantera, skapa, läsa och fråga efter exempeldata.

  1. Öppna en terminal i en tom katalog.

  2. Om du inte redan är autentiserad autentiserar du till Azure Developer CLI med .azd auth login Följ stegen som anges av verktyget för att autentisera till CLI med dina önskade Azure-autentiseringsuppgifter.

    azd auth login

  3. Använd azd init för att initiera projektet.

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

  4. Under initieringen konfigurerar du ett unikt miljönamn.

  5. Distribuera Azure Cosmos DB-kontot med .azd up Bicep-mallarna distribuerar också ett exempelwebbprogram.

    azd up

  6. Under etableringsprocessen väljer du din prenumeration, önskad plats och målresursgrupp. Vänta tills etableringsprocessen har slutförts. Processen kan ta ungefär fem minuter.

  7. När etableringen av dina Azure-resurser är klar inkluderas en URL till det webbprogram som körs i utdata.

    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. Använd URL:en i konsolen för att navigera till webbprogrammet i webbläsaren. Observera utdata från appen som körs.

Skärmbild av webbprogrammet som körs.

Installera klientbiblioteket

Klientbiblioteket är tillgängligt via PyPi som pymongo paket.

  1. Öppna en terminal och navigera till /src mappen.

    cd ./src

  2. Om det inte redan är installerat installerar du pymongo paketet med .pip install

    pip install pymongo

  3. Öppna och granska filen src/requirements.txt för att verifiera att posten pymongo finns.

Objektmodell

Name beskrivning
MongoClient Typ som används för att ansluta till MongoDB.
Database Representerar en databas i kontot.
Collection Representerar en samling i en databas i kontot.

Kodexempel

Exempelkoden i mallen använder en databas med namnet cosmicworks och samlingen med namnet products. Samlingen products innehåller information som namn, kategori, kvantitet och en unik identifierare för varje produkt. Samlingen använder egenskapen /category som en shardnyckel.

Autentisera klienten

Det här exemplet skapar en ny instans av MongoClient typen.

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

client = MongoClient(connection_string)

Hämta en databas

Det här exemplet skapar en instans av Database typen med hjälp get_database av funktionen av typen MongoClient .

database = client.get_database("<database-name>")

Hämta en samling

Det här exemplet skapar en instans av Collection typen med hjälp get_collection av funktionen av typen Database .

collection = database.get_collection("<collection-name>")

Skapa ett dokument

Skapa ett dokument i samlingen med .collection.update_one Den här metoden "upserts" objektet ersätter objektet effektivt om det redan finns.

new_document = {
    "_id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "category": "gear-surf-surfboards",
    "name": "Yamba Surfboard",
    "quantity": 12,
    "sale": False,
}

filter = {
    "_id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "category": "gear-surf-surfboards"
}
payload = {
    "$set": new_document
}
result = collection.update_one(filter, payload, upsert=True);

Läsa ett dokument

Utför en punktläsningsåtgärd med hjälp av både de unika identifierarna (id) och shardnyckelfälten. Använd collection.find_one för att effektivt hämta det specifika objektet.

filter = {
    "_id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
    "category": "gear-surf-surfboards"
}
existing_document = collection.find_one(filter)

Köra en fråga mot dokument

Utför en fråga över flera objekt i en container med hjälp av collection.find. Den här frågan hittar alla objekt inom en angiven kategori (shardnyckel).

filter = {
    "category": "gear-surf-surfboards"
}

matched_documents = collection.find(filter)

for document in matched_documents:
    # Do something with each item

Utforska dina data

Använd Visual Studio Code-tillägget för Azure Cosmos DB för att utforska dina MongoDB-data. Du kan utföra grundläggande databasåtgärder, inklusive, men inte begränsat till:

  • Köra frågor med hjälp av en klippbok eller frågeredigeraren
  • Ändra, uppdatera, skapa och ta bort dokument
  • Importera massdata från andra källor
  • Hantera databaser och samlingar

Mer information finns i Använda Visual Studio Code-tillägget för att utforska Azure Cosmos DB för MongoDB-data.

Rensa resurser

När du inte längre behöver exempelprogrammet eller resurserna tar du bort motsvarande distribution och alla resurser.

azd down

Relaterat innehåll