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

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