Criar um contêiner no Azure Cosmos DB for NoSQL

  • Artigo

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 SDKs com suporte. Este artigo demonstra como criar um contêiner, especificar a chave de partição e a taxa de transferência de provisionamento.

Este artigo explica as diferentes maneiras de criar um contêiner no Azure Cosmos DB for NoSQL. Se você estiver usando outra API, confira os artigos API for MongoDB, API for Cassandra, API for Gremlin e API for Table para criar o contêiner.

Observação

Ao criar contêineres, não crie dois contêineres com o mesmo nome, mas com maiúsculas e minúsculas diferentes. Isso porque algumas partes da plataforma Azure não diferenciam maiúsculas de minúsculas, o que pode resultar em confusão/colisão de telemetria e ações em contêineres com tais nomes.

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 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.

    Screenshot of Data Explorer, with New Collection highlighted

Criar um contêiner usando a CLI do Azure

Criar contêiner com a CLI do Azure. Para obter uma lista de todos os exemplos de CLI do Azure em todas as APIs do Azure Cosmos DB, confira Amostras da CLI do Azure para Azure Cosmos DB.

Criar um contêiner usando o PowerShell

Criar um contêiner com o PowerShell. Para obter uma lista de todos os exemplos do PowerShell em todas as APIs do Azure Cosmos DB, confira Amostras do 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.

// Create a container with a partition key and provision 400 RU/s manual throughput.
CosmosClient client = new CosmosClient(connectionString, clientOptions);
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