Exemplos do Python do Azure Cosmos DBAzure Cosmos DB Python examples
APLICA-SE A:
SQL API
As soluções de amostra que fazem operações CRUD e outras operações comuns em recursos DB Azure Cosmos estão incluídas no repositório gitHub de azure-documentdb-python.Sample solutions that do CRUD operations and other common operations on Azure Cosmos DB resources are included in the azure-documentdb-python GitHub repository. Este artigo fornece:This article provides:
- Ligações para as tarefas em cada um dos ficheiros do projeto de exemplo do Python.Links to the tasks in each of the Python example project files.
- Ligações para o conteúdo de referência da API relacionada.Links to the related API reference content.
Pré-requisitosPrerequisites
- Uma conta de Cosmos DB.A Cosmos DB Account. As suas opções são:You options are:
- Dentro de uma subscrição ativa do Azure:Within an Azure active subscription:
- Crie uma Conta Gratuita Azure ou use a subscrição existenteCreate an Azure free Account or use your existing subscription
- Créditos mensais do Estúdio VisualVisual Studio Monthly Credits
- Azure Cosmos DB Free TierAzure Cosmos DB Free Tier
- Sem uma subscrição ativa do Azure:Without an Azure active subscription:
- Experimente gratuitamente Azure Cosmos DB,um ambiente de testes que dura 30 dias.Try Azure Cosmos DB for free, a tests environment that lasts for 30 days.
- Emulador do Azure Cosmos DBAzure Cosmos DB Emulator
- Dentro de uma subscrição ativa do Azure:Within an Azure active subscription:
- Python 2.7 ou 3.6+, com o
python
executável no seuPATH
.Python 2.7 or 3.6+, with thepython
executable in yourPATH
. - Visual Studio Code.Visual Studio Code.
- A extensão Python para Código de Estúdio Visual.The Python extension for Visual Studio Code.
- Git.Git.
- Azure Cosmos DB SQL API SDK para PythonAzure Cosmos DB SQL API SDK for Python
Exemplos de base de dadosDatabase examples
A amostra database_management.py Python mostra como fazer as seguintes tarefas.The database_management.py Python sample shows how to do the following tasks. Para conhecer as bases de dados do Azure Cosmos antes de executar as seguintes amostras, consulte Trabalhar com bases de dados, contentores e artigos conceptuais.To learn about the Azure Cosmos databases before running the following samples, see Working with databases, containers, and items conceptual article.
TarefaTask | Referência da APIAPI reference |
---|---|
Criar uma base de dadosCreate a database | CosmosClient.create_databaseCosmosClient.create_database |
Leia uma base de dados por IDRead a database by ID | CosmosClient.get_database_clientCosmosClient.get_database_client |
Consultar as bases de dadosQuery the databases | CosmosClient.query_databasesCosmosClient.query_databases |
Listar bases de dados para uma contaList databases for an account | CosmosClient.list_databasesCosmosClient.list_databases |
Eliminar uma base de dadosDelete a database | CosmosClient.delete_databaseCosmosClient.delete_database |
Exemplos de contentorContainer examples
A amostra container_management.py Python mostra como fazer as seguintes tarefas.The container_management.py Python sample shows how to do the following tasks. Para conhecer as coleções Azure Cosmos antes de executar as seguintes amostras, consulte Trabalhar com bases de dados, contentores e artigos conceptuais.To learn about the Azure Cosmos collections before running the following samples, see Working with databases, containers, and items conceptual article.
TarefaTask | Referência da APIAPI reference |
---|---|
Consulta para um recipienteQuery for a container | database.query_containersdatabase.query_containers |
Criar um contentorCreate a container | database.create_containerdatabase.create_container |
Listar todos os contentores numa base de dadosList all the containers in a database | database.list_containersdatabase.list_containers |
Obtenha um recipiente pelo seu IDGet a container by its ID | database.get_container_clientdatabase.get_container_client |
Gerir a produção do contentor a provisionadaManage container's provisioned throughput | container.read_offer, container.replace_throughputcontainer.read_offer, container.replace_throughput |
Eliminar um contentorDelete a container | database.delete_containerdatabase.delete_container |
Exemplos de itensItem examples
A amostra item_management.py Python mostra como fazer as seguintes tarefas.The item_management.py Python sample shows how to do the following tasks. Para conhecer os documentos do Azure Cosmos antes de executar as seguintes amostras, consulte Trabalhar com bases de dados, contentores e artigos conceptuais.To learn about the Azure Cosmos documents before running the following samples, see Working with databases, containers, and items conceptual article.
TarefaTask | Referência da APIAPI reference |
---|---|
Criar itens num recipienteCreate items in a container | container.create_itemcontainer.create_item |
Leia um item pelo seu IDRead an item by its ID | container.read_itemcontainer.read_item |
Leia todos os itens num recipienteRead all the items in a container | container.read_all_itemscontainer.read_all_items |
Consulta um item pelo seu IDQuery an item by its ID | container.query_itemscontainer.query_items |
Substituir um itemReplace an item | container.replace_itemscontainer.replace_items |
Aumentar um itemUpsert an item | container.upsert_itemcontainer.upsert_item |
Eliminar um itemDelete an item | container.delete_itemcontainer.delete_item |
Obtenha a alteração de itens num recipienteGet the change feed of items in a container | container.query_items_change_feedcontainer.query_items_change_feed |
Exemplos de indexaçãoIndexing examples
A amostra index_management.py Python mostra como fazer as seguintes tarefas.The index_management.py Python sample shows how to do the following tasks. Para aprender sobre a indexação em Azure Cosmos DB antes de executar as seguintes amostras, consulte políticas de indexação, tipos de indexaçãoe artigos conceptuais de caminhos de indexação.To learn about indexing in Azure Cosmos DB before running the following samples, see indexing policies, indexing types, and indexing paths conceptual articles.
TarefaTask | Referência da APIAPI reference |
---|---|
Excluir um item específico da indexaçãoExclude a specific item from indexing | documents.IndexingDirective.Excludedocuments.IndexingDirective.Exclude |
Utilize indexação manual com itens específicos indexadosUse manual indexing with specific items indexed | documentos. IndexingDirective.Includedocuments.IndexingDirective.Include |
Excluir caminhos da indexaçãoExclude paths from indexing | Definir caminhos para excluir em IndexingPolicy propriedadeDefine paths to exclude in IndexingPolicy property |
Utilizar índices de intervalo em cadeiasUse range indexes on strings | Defina a política de indexação com índices de gama no tipo de dados de cadeia.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 |
Realizar uma transformação de índicePerform an index transformation | database.replace_container (utilizar a política de indexação atualizada)database.replace_container (use the updated indexing policy) |
Use digitalizações quando só existe índice de haxixe no caminhoUse scans when only hash index exists on the path | definir o enable_scan_in_query=True e ao consultar os enable_cross_partition_query=True itensset the enable_scan_in_query=True and enable_cross_partition_query=True when querying the items |