Partilhar via

Criar uma coleção no Azure Cosmos DB para MongoDB

  • Aplica-se a: ✅ MongoDB

Aplica-se a: MongoDB

Este artigo explica as diferentes formas de criar uma coleção no Azure Cosmos DB para MongoDB. Mostra como criar uma coleção usando o portal Azure, Azure CLI, PowerShell ou kits de desenvolvimento de software suportados (SDKs). Este artigo demonstra como criar uma coleção, especificar a chave de partição e provisionar o throughput.

Note

Contentores e coleções são semelhantes a uma tabela numa base de dados relacional. Referimo-nos a contentores no Azure Cosmos DB para NoSQL e em todo o portal Azure, enquanto usamos coleções no contexto do Azure Cosmos DB para MongoDB para corresponder à terminologia usada no MongoDB.

Este artigo explica as diferentes formas de criar uma coleção no Azure Cosmos DB para MongoDB. Se estiver a usar uma API diferente, consulte API para NoSQL, API para Cassandra, API para Gremlin e API para artigos de tabela para criar a coleção.

Note

Ao criar coleções, certifique-se de não criar duas coleções com o mesmo nome mas com capitalização diferente. Isto porque algumas partes da plataforma Azure não fazem distinção entre maiúsculas e minúsculas, o que pode resultar em confusão ou colisão de telemetria e ações em coleções com tais nomes.

Criar usando o portal Azure

  1. Inicie sessão no portal Azure.

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

  3. Abra o painel do Explorador de Dados e selecione Novo Contentor. De seguida, forneça os seguintes detalhes:

    • Indique se está a criar uma nova base de dados ou a usar uma já existente.
    • Introduza um ID de contentor.
    • Introduz uma chave fragmentada.
    • Indique um throughput a ser provisionado (por exemplo, 1000 RUs).
    • Selecione OK.

    Captura de ecrã do Azure Cosmos DB para MongoDB, caixa de diálogo Adicionar Contentor

Criar usando o SDK .NET

var bson = new BsonDocument
{
    { "customAction", "CreateCollection" },
    { "collection", "<CollectionName>" },//update CollectionName
    { "shardKey", "<ShardKeyName>" }, //update ShardKey
    { "offerThroughput", 400} //update Throughput
};
var shellCommand = new BsonDocumentCommand<BsonDocument>(bson);
// Create a collection with a partition key by using Mongo Driver:
db.RunCommand(shellCommand);

Se encontrar uma exceção de timeout ao criar uma coleção, faça uma operação de leitura para validar se a coleção foi criada com sucesso. A operação de leitura gera uma exceção até que a operação de criação da coleção seja bem-sucedida. Para a lista de códigos de estado suportados pela operação de criação, consulte o artigo HTTP Status Codes for Azure Cosmos DB .

Crie uma coleção usando templates Azure Resource Manager

Crie uma coleção para Azure Cosmos DB para API para MongoDB com o modelo Resource Manager.

Próximos passos

  • Last updated on