Dela via

Exempel för Azure Cosmos DB för NoSQL SDK för Python

  • Artikel

GÄLLER FÖR: NoSQL

Exempellösningar som utför CRUD-åtgärder och andra vanliga åtgärder på Azure Cosmos DB-resurser ingår i mappen på main/sdk/cosmos GitHub-lagringsplatsen azure/azure-sdk-for-python. Den här artikeln innehåller:

  • Länkar till uppgifterna i var och en av Python-exempelprojektfilerna.
  • Länkar till det relaterade API-referensinnehållet.

Förutsättningar

Databasexempel

I database_management.py Python-exempel visas hur du utför följande uppgifter med hjälp av CosmosClient-metoder. Mer information om Azure Cosmos DB-databaserna innan du kör följande exempel finns i artikeln Arbeta med databaser, containrar och objekt .

Uppgift API-referens
Skapa en databas CosmosClient.create_database
Läsa en databas via ID CosmosClient.get_database_client
Fråga databaserna CosmosClient.query_databases
Lista databaser för ett konto CosmosClient.list_databases
Ta bort en databas CosmosClient.delete_database

Containerexempel

I container_management.py Python-exempel visas hur du utför följande uppgifter med hjälp av DatabaseProxy-metoder. Mer information om Azure Cosmos DB-samlingarna innan du kör följande exempel finns i artikeln Arbeta med databaser, containrar och objekt .

Uppgift API-referens
Fråga efter en container database.query_containers
Skapa en container database.create_container
Visa en lista över alla containrar i en databas database.list_containers
Hämta en container med dess ID database.get_container_client
Hantera containerns etablerade dataflöde container.replace_throughput
Ta bort en container database.delete_container

Objektexempel

Exemplen document_management.py och change_feed_management.py Python visar hur du utför följande uppgifter med hjälp av ContainerProxy-metoder. Mer information om Azure Cosmos DB-objekt innan du kör följande exempel finns i artikeln Arbeta med databaser, containrar och objekt .

Uppgift API-referens
Skapa objekt i en container container.create_item
Läsa ett objekt med dess ID container.read_item
Läsa alla objekt i en container container.read_all_items
Fråga ett objekt efter dess ID container.query_items
Ersätta ett objekt container.replace_item
Upsert ett objekt container.upsert_item
Ta bort ett objekt container.delete_item
Hämta ändringsflödet för objekt i en container container.query_items_change_feed

Indexeringsexempel

I index_management.py Python-exempel visas hur du utför följande uppgifter. Mer information om indexering i Azure Cosmos DB innan du kör följande exempel finns i konceptuella artiklar om indexeringsprinciper, indexeringstyper och indexeringssökvägar.

Uppgift API-referens
Undanta ett specifikt objekt från indexering Dokument.IndexingDirective. Utesluta
Använd manuell indexering med specifika objekt indexerade Dokument. IndexingDirective.Include
Undanta sökvägar från indexering Definiera sökvägar som ska undantas i egenskapen IndexingPolicy
Använda intervallindex i strängar Definiera indexeringsprincip med intervallindex för strängdatatyp. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Utföra en indextransformering databas. replace_container (använd den uppdaterade indexeringsprincipen)
Använda genomsökningar när endast hash-index finns på sökvägen enable_scan_in_query=True ange och enable_cross_partition_query=True när du frågar efter objekten

Nästa steg

Försöker du planera kapacitet för en migrering till Azure Cosmos DB? Du kan använda information om ditt befintliga databaskluster för kapacitetsplanering.