Exemples spécifiques au kit SDK Azure Cosmos DB for NoSQL pour Python

  • Article

S’APPLIQUE À : NoSQL

Des exemples de solutions qui effectuent des opérations CRUD, ainsi que d’autres opérations courantes sur les ressources Azure Cosmos DB, se trouvent dans le dossier main/sdk/cosmos du dépôt GitHub azure/azure-sdk-for-python. Cet article fournit :

  • Liens vers les tâches dans chacun des exemples de fichiers de projet Python.
  • Des liens vers le contenu de référence d’API connexe.

Prérequis

Exemples de base de données

L’exemple Python database_management.py montre comment effectuer les tâches suivantes à l’aide des méthodes CosmosClient. Pour en savoir plus sur les bases de données Azure Cosmos DB avant d’exécuter les exemples suivants, consultez l’article conceptuel Utiliser des bases de données, des conteneurs et des éléments.

Tâche Informations de référence sur l'API
Créer une base de données CosmosClient.create_database
Lire une base de données par identifiant CosmosClient.get_database_client
Interroger les bases de données CosmosClient.query_databases
Répertorier les bases de données pour un compte CosmosClient.list_databases
Supprimer une base de données CosmosClient.delete_database

Exemples de conteneur

L’exemple Python container_management.py montre comment effectuer les tâches suivantes à l’aide des méthodes DatabaseProxy. Pour en savoir plus sur les collections Azure Cosmos DB avant d’exécuter les exemples suivants, consultez l’article conceptuel Utiliser des bases de données, des conteneurs et des éléments.

Tâche Informations de référence sur l'API
Rechercher un conteneur database.query_containers
Créer un conteneur database.create_container
Lister tous les conteneurs d’une base de données database.list_containers
Obtenir un conteneur par son ID database.get_container_client
Gérer le débit provisionné du conteneur container.replace_throughput
Supprimer un conteneur database.delete_container

Exemples d’éléments

Les exemples Python document_management.py et change_feed_management.py montrent comment effectuer les tâches suivantes à l’aide des méthodes ContainerProxy. Pour en savoir plus sur les éléments Azure Cosmos DB avant d’exécuter les exemples suivants, consultez l’article conceptuel Utilisation des bases de données, des conteneurs et des éléments.

Tâche Informations de référence sur l'API
Créer des éléments dans un conteneur container.create_item
Lire un élément par son ID container.read_item
Lire tous les éléments figurant dans un conteneur container.read_all_items
Interroger un élément par son ID container.query_items
Remplacer un élément container.replace_item
Effectuer une opération Upsert sur un élément container.upsert_item
Supprimer un élément container.delete_item
Obtenir le flux de modification des éléments dans un conteneur container.query_items_change_feed

Exemples d'indexation

L’exemple Python index_management.py explique comment effectuer les tâches suivantes. Pour en savoir plus sur l’indexation dans Azure Cosmos DB avant d’exécuter les exemples suivants, consultez les articles conceptuels sur les stratégies d’indexation, les types d’indexation et les chemins d’indexation.

Tâche Informations de référence sur l'API
Exclure un élément spécifique de l’indexation documents.IndexingDirective.Exclude
Utiliser l’indexation manuelle avec des éléments spécifiques indexés documents.IndexingDirective.Include
Exclure de l’indexation des chemins Définir les chemins à exclure dans la propriété IndexingPolicy
Utiliser les index de plage sur les chaînes Définissez la stratégie d’indexation avec des index de plage sur le type de données String. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Effectuer une transformation d’index database.replace_container (utilisez la stratégie d’indexation mise à jour)
Utiliser des analyses lorsque seul un index de hachage existe sur le chemin Définissez enable_scan_in_query=True et enable_cross_partition_query=True lors de l’interrogation des éléments

Étapes suivantes

Vous tentez d’effectuer une planification de la capacité pour une migration vers Azure Cosmos DB ? Vous pouvez utiliser les informations sur votre cluster de bases de données existant pour la planification de la capacité.