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

Artigo
08/15/2024

APLICA-SE AO: MongoDB

Este artigo explica as diferentes maneiras de criar uma coleção no Azure Cosmos DB for MongoDB. Ele mostra como criar uma coleção usando o portal do Azure, a CLI do Azure, o PowerShell ou SDKs com suporte. Este artigo demonstra como criar uma coleção, especificar a chave de partição e a taxa de transferência de provisionamento.

Observação

Os contêineres e as coleções são semelhantes a uma tabela em um banco de dados relacional. Usamos o termo contêineres no Azure Cosmos DB for NoSQL e em todo o portal do Azure e usamos o termo coleções no contexto do Azure Cosmos DB for MongoDB para corresponder à terminologia usada no MongoDB.

Este artigo explica as diferentes maneiras de criar uma coleção no Azure Cosmos DB for MongoDB. Se você estiver usando uma API diferente, confira os artigos API do NoSQL, API do Cassandra, API do Gremlin e API de Tabela para criar uma coleção.

Observação

Ao criar coleções, não crie duas coleções 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 coleções com esses nomes.

Criar usando o portal do Azure

Entre no portal do Azure.
Crie uma conta do Azure Cosmos DB ou selecione uma conta existente.
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 uma ID de contêiner.
- Insira uma chave de fragmento.
- Insira uma taxa de transferência a ser provisionada (por exemplo, 1.000 RUs).
- Selecione OK.

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 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, veja o artigo Códigos de status HTTP do Azure Cosmos DB.

Criar usando a CLI do Azure

Crie uma coleção para a API do Azure Cosmos DB for MongoDB com a CLI do Azure. Para obter uma lista de todos exemplos de CLI do Azure em todas as APIs do Azure Cosmos DB, veja Amostras da CLI do Azure para Azure Cosmos DB.

Criar usando o PowerShell

Crie uma coleção para a API do Azure Cosmos DB for MongoDB com o PowerShell. Para obter uma lista de todos os exemplos do PowerShell em todas as APIs do Azure Cosmos DB, veja Amostras do PowerShell

Criar uma coleção usando modelos do Azure Resource Manager

Crie uma coleção da API do Azure Cosmos DB for MongoDB com um modelo do Resource Manager.

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
Tentando fazer o planejamento da capacidade para uma migração para o Azure Cosmos DB? Você pode usar informações sobre o cluster de banco de dados existente para fazer isso.
- Se você sabe apenas o número de vCores e servidores no cluster de banco de dados existente, leia sobre como estimar unidades de solicitação com vCores ou vCPUs
- Se souber as taxas de solicitação típicas da carga de trabalho do banco de dados atual, leia sobre como estimar unidades de solicitação usando o planejador de capacidade do Azure Cosmos DB

Compartilhar via