Esempi Python per Azure Cosmos DBAzure Cosmos DB Python examples

SI APPLICA A: API SQL

Il repository azure-documentdb-python di GitHub include soluzioni di esempio che effettuano operazioni CRUD e altre operazioni comuni su risorse di Azure Cosmos DB.Sample solutions that do CRUD operations and other common operations on Azure Cosmos DB resources are included in the azure-documentdb-python GitHub repository. Questo articolo include:This article provides:

  • Collegamenti alle attività in ogni file di progetto Python di esempio.Links to the tasks in each of the Python example project files.
  • Collegamenti al contenuto di riferimento sulle API correlato.Links to the related API reference content.

PrerequisitiPrerequisites

Esempi di databaseDatabase examples

L'esempio database_management.py di Python mostra come eseguire le attività seguenti.The database_management.py Python sample shows how to do the following tasks. Per saperne di più sui database di Azure Cosmos prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.To learn about the Azure Cosmos databases before running the following samples, see Working with databases, containers, and items conceptual article.

AttivitàTask Informazioni di riferimento sulle APIAPI reference
Creare un databaseCreate a database CosmosClient.create_databaseCosmosClient.create_database
Leggere un database in base all'IDRead a database by ID CosmosClient.get_database_clientCosmosClient.get_database_client
Eseguire query sul databaseQuery the databases CosmosClient.query_databasesCosmosClient.query_databases
Elencare database per un accountList databases for an account CosmosClient.list_databasesCosmosClient.list_databases
Eliminare un databaseDelete a database CosmosClient.delete_databaseCosmosClient.delete_database

Esempi di contenitoreContainer examples

L'esempio container_management.py di Python mostra come eseguire le attività seguenti.The container_management.py Python sample shows how to do the following tasks. Per saperne di più sulle raccolte di Azure Cosmos prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.To learn about the Azure Cosmos collections before running the following samples, see Working with databases, containers, and items conceptual article.

AttivitàTask Informazioni di riferimento sulle APIAPI reference
Eseguire query per trovare un contenitoreQuery for a container database.query_containersdatabase.query_containers
Creare un contenitoreCreate a container database.create_containerdatabase.create_container
Elencare tutti i contenitori in un databaseList all the containers in a database database.list_containersdatabase.list_containers
Ottenere un contenitore in base all'IDGet a container by its ID database.get_container_clientdatabase.get_container_client
Gestire la velocità effettiva con provisioning del contenitoreManage container's provisioned throughput container.read_offer, container.replace_throughputcontainer.read_offer, container.replace_throughput
Eliminare un contenitoreDelete a container database.delete_containerdatabase.delete_container

Esempi di elementiItem examples

L'esempio item_management.py di Python mostra come eseguire le attività seguenti.The item_management.py Python sample shows how to do the following tasks. Per saperne di più sui documenti di Azure Cosmos prima di passare agli esempi seguenti, vedere l'articolo concettuale Usare database, contenitori ed elementi.To learn about the Azure Cosmos documents before running the following samples, see Working with databases, containers, and items conceptual article.

AttivitàTask Informazioni di riferimento sulle APIAPI reference
Creare elementi in un contenitoreCreate items in a container container.create_itemcontainer.create_item
Leggere un elemento in base all'IDRead an item by its ID container.read_itemcontainer.read_item
Leggere tutti gli elementi in un contenitoreRead all the items in a container container.read_all_itemscontainer.read_all_items
Eseguire query su un elemento in base all'IDQuery an item by its ID container.query_itemscontainer.query_items
Sostituire un elementoReplace an item container.replace_itemscontainer.replace_items
Upsert di un elementoUpsert an item container.upsert_itemcontainer.upsert_item
Eliminare un elementoDelete an item container.delete_itemcontainer.delete_item
Ottenere il feed delle modifiche degli elementi di un contenitoreGet the change feed of items in a container container.query_items_change_feedcontainer.query_items_change_feed

Esempi di indicizzazioneIndexing examples

L'esempio index_management.py di Python mostra come eseguire le attività seguenti.The index_management.py Python sample shows how to do the following tasks. 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.To learn about indexing in Azure Cosmos DB before running the following samples, see indexing policies, indexing types, and indexing paths conceptual articles.

AttivitàTask Informazioni di riferimento sulle APIAPI reference
Escludere un elemento specifico dall'indiceExclude a specific item from indexing documents.IndexingDirective.Excludedocuments.IndexingDirective.Exclude
Usare l'indicizzazione manuale con elementi specifici indicizzatiUse manual indexing with specific items indexed documents.IndexingDirective.Includedocuments.IndexingDirective.Include
Escludere percorsi dall'indicizzazioneExclude paths from indexing Definire i percorsi da escludere nella proprietà IndexingPolicyDefine paths to exclude in IndexingPolicy property
Usare gli indici di intervallo sulle stringheUse range indexes on strings Definire i criteri di indicizzazione con indici di intervallo per il tipo di dati stringa.Define indexing policy with range indexes on string data type. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Eseguire una trasformazione dell'indicePerform an index transformation database.replace_container (usare i criteri di indicizzazione aggiornati)database.replace_container (use the updated indexing policy)
Usare le analisi quando nel percorso esiste solo l'indice hashUse scans when only hash index exists on the path Impostare enable_scan_in_query=True e enable_cross_partition_query=True quando si eseguono query sugli elementiset the enable_scan_in_query=True and enable_cross_partition_query=True when querying the items