Criar um contêiner no Azure Cosmos DB para NoSQL

  • Artigo

APLICA-SE A: NoSQL

Este artigo explica as diferentes maneiras de criar um contêiner no Azure Cosmos DB para NoSQL. Ele mostra como criar um contêiner usando o portal do Azure, a CLI do Azure, o PowerShell ou SDKs suportados. 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 para NoSQL. Se você estiver usando uma API diferente, consulte API para MongoDB, API para Cassandra, API para Gremlin e API para artigos de tabela para criar o contêiner.

Nota

Ao criar contêineres, certifique-se de não criar dois contêineres com o mesmo nome, mas com invólucros diferentes. Isso ocorre porque algumas partes da plataforma Azure não diferenciam maiúsculas de minúsculas, e isso pode resultar em confusão/colisão de telemetria e ações em contêineres com esses nomes.

Criar um contentor com o portal do Azure

  1. Inicie sessão no portal do Azure.

  2. Crie uma nova 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 está a criar uma nova base de dados ou a utilizar uma base de dados existente.
    • Insira um ID de contêiner.
    • Insira um valor de chave de partição (por exemplo, /ItemID).
    • Selecione Dimensionamento automático ou Taxa de transferência manual e insira a taxa de transferência de contêiner necessária (por exemplo, 1000 RU/s). Insira uma taxa de transferência que você deseja provisionar (por exemplo, 1000 RUs).
    • Selecione OK.

    Screenshot of Data Explorer, with New Collection highlighted

Criar um contentor com a CLI do Azure

Crie um contêiner com a CLI do Azure. Para obter uma lista de todos os exemplos da CLI do Azure em todas as APIs do Azure Cosmos DB, consulte Exemplos da CLI do Azure para o Azure Cosmos DB.

Criar um contêiner usando o PowerShell

Crie um contêiner com o PowerShell. Para obter uma lista de todos os exemplos do PowerShell em todas as APIs do Azure Cosmos DB, consulte Exemplos do PowerShell

Criar um contentor com o SDK .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 lança uma exceção até que a operação de criação de coleção seja bem-sucedida. Para obter a lista de códigos de status suportados pela operação create, consulte o artigo Códigos de status HTTP para o 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óximos passos