Criar um contêiner no Azure Cosmos DB for NoSQL

APLICA-SE A: NoSQL

Este artigo explica as diferentes maneiras de criar um contêiner no Azure Cosmos DB for NoSQL. Ele mostra como criar um contêiner usando o portal do Azure, a CLI do Azure, o PowerShell ou os SDKs (kits de desenvolvimento de software) com suporte. Este artigo demonstra como criar um contêiner, especificar a chave de partição e provisionar a taxa de transferência.

Este artigo explica as diferentes maneiras de criar um contêiner no Azure Cosmos DB for NoSQL. Se você estiver usando uma API diferente, consulte a API para MongoDB, a API para Cassandra, a API para Gremlin e os artigos da API para Tabela para criar o contêiner.

Criar um contêiner usando o portal do Azure

1. Entre no portal do Azure.

2. Crie uma conta do Azure Cosmos DB ou selecione uma conta existente.

3. Abra o painel Data Explorer e selecione Novo Contêiner. Em seguida, forneça os seguintes detalhes:

   • Indique se você está criando um novo banco de dados ou usando um existente.
   • Insira um ID de contêiner.
   • Insira um valor de chave de partição (por exemplo, /ItemID).
   • Selecione a taxa de transferência com Dimensionamento automático ou Manual e insira a Taxa de transferência do contêiner necessária (por exemplo, 1000 RU/s). Insira uma taxa de transferência que você deseja provisionar (por exemplo, 1.000 RUs).
   • Selecione OK.

   

Criar um contêiner usando a CLI do Azure

Criar contêiner com a CLI do Azure.

Criar um contêiner usando o PowerShell

Criar um contêiner com o PowerShell.

Criar um contêiner usando o SDK do .NET

Se você encontrar uma exceção de tempo limite ao criar uma coleção, execute uma operação de leitura para validar se a coleção foi criada com êxito. A operação de leitura gera uma exceção até que a operação de criação da coleção seja bem-sucedida. Para obter a lista de códigos de status com suporte pela operação de criação, confira o artigo Códigos de Status HTTP para Azure Cosmos DB.

TokenCredential credential = new DefaultAzureCredential();

CosmosClient client = new (
    accountEndpoint: "<nosql-account-endpoint>",
    tokenCredential: credential
);

// Create a container with a partition key and provision 400 RU/s manual throughput.
Database database = await client.CreateDatabaseIfNotExistsAsync(databaseId);

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = containerId,
    PartitionKeyPath = "/myPartitionKey"
};

var throughput = ThroughputProperties.CreateManualThroughput(400);
Container container = await database.CreateContainerIfNotExistsAsync(containerProperties, throughput);

Próximas etapas

• Particionamento no Azure Cosmos DB
• Unidades de Solicitação no Azure Cosmos DB
• Provisionar a taxa de transferência para contêineres e bancos de dados
• Como trabalhar com a conta do Azure Cosmos DB