Esempi per Azure Cosmos DB for NoSQL SDK per Python

  • Articolo

SI APPLICA A: NoSQL

La cartella main/sdk/cosmos del repository azure/azure-sdk-for-python di GitHub include soluzioni di esempio che effettuano operazioni CRUD e altre operazioni comuni su risorse di Azure Cosmos DB. Questo articolo include:

  • Collegamenti alle attività in ogni file di progetto Python di esempio.
  • Collegamenti al contenuto di riferimento sulle API correlato.

Prerequisiti

Esempi di database

L'esempio database_management.py di Python mostra come eseguire le attività seguenti usando i metodi CosmosClient. Per saperne di più sui database di Azure Cosmos DB prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.

Attività Informazioni di riferimento sulle API
Creare un database CosmosClient.create_database
Leggere un database in base all'ID CosmosClient.get_database_client
Eseguire query sul database CosmosClient.query_databases
Elencare database per un account CosmosClient.list_databases
Eliminare un database CosmosClient.delete_database

Esempi di contenitore

L'esempio container_management.py di Python mostra come eseguire le attività seguenti usando i metodi DatabaseProxy. Per saperne di più sulle raccolte di Azure Cosmos DB prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.

Attività Informazioni di riferimento sulle API
Eseguire query per trovare un contenitore database.query_containers
Creare un contenitore database.create_container
Elencare tutti i contenitori in un database database.list_containers
Ottenere un contenitore in base all'ID database.get_container_client
Gestire la velocità effettiva con provisioning del contenitore container.replace_throughput
Eliminare un contenitore database.delete_container

Esempi di elementi

Gli esempi di document_management.py e change_feed_management.py di Python illustrano come eseguire le attività seguenti usando metodi ContainerProxy. Per saperne di più sugli elementi Azure Cosmos DB prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.

Attività Informazioni di riferimento sulle API
Creare elementi in un contenitore container.create_item
Leggere un elemento in base all'ID container.read_item
Leggere tutti gli elementi in un contenitore container.read_all_items
Eseguire query su un elemento in base all'ID container.query_items
Sostituire un elemento container.replace_item
Upsert di un elemento container.upsert_item
Eliminare un elemento container.delete_item
Ottenere il feed delle modifiche degli elementi di un contenitore container.query_items_change_feed

Esempi di indicizzazione

L'esempio index_management.py di Python mostra come eseguire le attività seguenti. Per saperne di più sull'indicizzazione in Azure Cosmos DB prima di passare agli esempi seguenti, vedere gli articoli concettuali su criteri di indicizzazione, tipi di indicizzazione e percorsi di indicizzazione.

Attività Informazioni di riferimento sulle API
Escludere un elemento specifico dall'indice documents.IndexingDirective.Exclude
Usare l'indicizzazione manuale con elementi specifici indicizzati documents.IndexingDirective.Include
Escludere percorsi dall'indicizzazione Definire i percorsi da escludere nella proprietà IndexingPolicy
Usare gli indici di intervallo sulle stringhe Definire i criteri di indicizzazione con indici di intervallo per il tipo di dati stringa. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Eseguire una trasformazione dell'indice database.replace_container (usare i criteri di indicizzazione aggiornati)
Usare le analisi quando nel percorso esiste solo l'indice hash Impostare enable_scan_in_query=True e enable_cross_partition_query=True quando si eseguono query sugli elementi

Passaggi successivi

Si sta tentando di pianificare la capacità per una migrazione ad Azure Cosmos DB? È possibile usare le informazioni del cluster di database esistente per la pianificazione della capacità.