Esempi per Azure Cosmos DB for NoSQL SDK per Python
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.
- Un account Azure Cosmos DB. Le opzioni possibili sono:
- All'interno di una sottoscrizione di Azure attiva:
- Creare un account Azure gratuito o usare una sottoscrizione esistente
- Crediti mensili di Visual Studio
- Livello gratuito di Azure Cosmos DB
- Senza una sottoscrizione di Azure attiva:
- Provare Azure Cosmos DB gratuitamente, un ambiente di test con validità di 30 giorni.
- Emulatore di Azure Cosmos DB
- All'interno di una sottoscrizione di Azure attiva:
- Python 3.7+, con il file eseguibile
python
inPATH
. Per altre informazioni, vedere i Criteri di supporto della versione di Python negli SDK di Azure. - Visual Studio Code.
- Estensione Python per Visual Studio Code.
- Git.
- Azure Cosmos DB for NoSQL SDK per Python
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 |
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 |
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 |
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 |
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à.
- Se si conosce solo il numero di vCore e server nel cluster di database esistente, leggere le informazioni sulla stima delle unità richieste con vCore o vCPU
- Se si conosce la frequenza delle richieste tipiche per il carico di lavoro corrente del database, leggere le informazioni sulla stima delle unità richieste con lo strumento di pianificazione della capacità di Azure Cosmos DB