db.createCollection()

Opcional. O nome do campo que contém metadados em cada documento de série temporal. Os metadados no campo especificado devem ser dados utilizados para rotular uma série exclusiva de documentos. Os metadados devem mudar raramente ou nunca.

O nome do campo especificado não pode ser _id ou o mesmo que o timeseries.timeField. O campo pode ser de qualquer tipo, exceto array.

Opcional, não use se estiver configurando bucketRoundingSeconds e bucketMaxSpanSeconds. Os valores possíveis são seconds (padrão), minutes e hours.

Defina granularity para o valor que melhor corresponde ao tempo entre os registros de data/hora de entrada consecutivos. Isso melhora o desempenho otimizando a forma interna de como o MongoDB armazena dados na coleção.

Para obter mais informações sobre granularidade e intervalos de bucket, consulte Definir granularidade para dados de séries temporais.

Opcional, usado com bucketRoundingSeconds como alternativa a granularity. Define o tempo máximo entre os registros de data/hora no mesmo bucket. Os valores possíveis são 1-31536000. Se você definir bucketMaxSpanSeconds, deverá definir bucketRoundingSeconds para o mesmo valor.

Para fazer o downgrade abaixo do MongoDB 6.3, você deve modificar a coleção para usar o valor granularity correspondente ou descartar a coleção. Para obter detalhes, consulte collMod.

Opcional, usado com bucketMaxSpanSeconds como alternativa a granularity. Define o número de segundos para arredondar para baixo quando o MongoDB define o timestamp mínimo para um novo bloco. Deve ser igual a bucketMaxSpanSeconds.

Por exemplo, definir ambos os parâmetros como 1800 arredonda os novos blocos para os 30 minutos mais próximos. Se um documento com um tempo de 2023-03-27T18:24:35Z não se encaixa em um bloco existente, o MongoDB cria um novo bloco com um mínimo de tempo de 2023-03-27T18:00:00Z e um tempo máximo de 2023-03-27T18:30:00Z.

Opcional. Especifica os segundos após os quais os documentos em uma coleção de séries temporais ou clustered collection expiram. O MongoDB exclui documentos expirados automaticamente.

Nas clustered collections, os documentos são excluídos automaticamente com base na chave de índice agrupada _id e os valores devem ser tipos de data. Consulte Índices TTL.

A partir do MongoDB 5.3, você pode criar uma coleção com um índice clusterizado. Os índices clusterizados são armazenados no mesmo arquivo WiredTiger da coleção. A coleção resultante é chamada de coleção clusterizada.

O campo clusteredIndex tem a seguinte sintaxe:

clusteredIndex: {
   key: <object>,
   unique: <boolean>,
   name: <string>
}

key

Obrigatório. O campo-chave do índice clusterizado. Deve ser definido como { _id: 1 }. O valor padrão para o campo _id é um identificador de objeto exclusivo gerado automaticamente, mas você pode definir seus próprios valores-chave de índice agrupados.

unique

Obrigatório. Deve ser true. Um índice exclusivo indica que a collection não aceitará documentos inseridos nem atualizados onde o valor da chave de índice clusterizado corresponde a um valor existente no índice.

name

Opcional. Um nome que identifica exclusivamente o índice agrupado.

Opcional.

A partir do MongoDB 6.0, você pode usar eventos change stream para produzir a versão de um documento antes e depois das alterações (pré e pós-imagens do documento):

• A pré-imagem é o documento antes de ser substituído, atualizado ou excluído. Não há pré-imagem para um documento inserido.

• A pós-imagem é o documento após ter sido inserido, substituído ou atualizado. Não há pós-imagem para um documento excluído.

• Habilite changeStreamPreAndPostImages para uma coleção usando db.createCollection(), create ou collMod.

changeStreamPreAndPostImages tem a seguinte sintaxe:

changeStreamPreAndPostImages: {
   enabled: <boolean>
}

Para habilitar a alteração de pré e pós-imagens de fluxo de alterações para uma coleção, defina enabled como true.

Para obter exemplos completos com a saída do fluxo de alterações, consulte Fluxos de alterações com imagens pré e pós-documento.

Para db.createCollection() ver um exemplo nessa página, consulte Criar uma coleção com imagens prévias e posteriores do fluxo de alterações para documentos.

Opcional. Disponível apenas para o WiredTiger Storage Engine.

Permite que os usuários especifiquem a configuração para o mecanismo de armazenamento em uma base por coleção ao criar uma coleção. O valor da opção storageEngine deve ter o seguinte formato:

{ <storage-engine-name>: <options> }

A configuração do mecanismo de armazenamento especificada ao criar coleções é validada e registrada no oplog durante a replicação para dar suporte a conjuntos de réplica com mecanismos de armazenamento diferentes.

A partir do MongoDB 7.2, você não pode especificar as opções de criptografia do mecanismo de armazenamento wiredTiger ao criar uma collection com db.createCollection(). Para configurar a criptografia para o mecanismo de armazenamento WiredTiger, consulte Encryption at rest.

Para obter detalhes, consulte Especificar opções do mecanismo de armazenamento.

Opcional. Permite aos usuários especificar regras ou expressões de validação para a coleção.

A opção validator requer um documento que especifica as regras ou expressões de validação. Você pode especificar as expressões usando os mesmos operadores que os operadores de consulta, com exceção de $near, $nearSphere, $text e $where.

Para saber como criar uma collection com validação de esquema, consulte Especificar Validação de JSON schema.

Opcional. Determina quão rigorosamente o MongoDB aplica as regras de validação aos documentos existentes durante uma atualização.

"off"

Nenhuma validação para inserções ou atualizações.

"strict"

Padrão Aplique regras de validação a todas as inserções e todas as atualizações.

"moderate"

Aplique regras de validação a inserções e atualizações em documentos válidos existentes. Não aplique regras a atualizações em documentos inválidos existentes.

Para ver um exemplo que utiliza o validationLevel, consulte Especificar nível de validação para documentos existentes.

Opcional. Determina se error em documentos inválidos ou apenas warn sobre as violações, mas permite que documentos inválidos sejam inseridos.

IMPORTANTE: a validação de documentos só se aplica aos documentos como determinado pelo validationLevel.

Para ver um exemplo que usa validationAction, consulte Escolher como manipular documentos inválidos.

Opcional. Permite que os usuários especifiquem uma configuração padrão para índices ao criar uma coleção.

A opção indexOptionDefaults aceita um documento storageEngine, que deve receber o seguinte formulário:

{ <storage-engine-name>: <options> }

A set do mecanismo de armazenamento especificada na criação de índices é validada e registrada no oplog durante a replicação para oferecer suporte a conjuntos de réplicas com membros que usam mecanismos de armazenamento diferentes.

Especifica a coleção padrão para a coleção.

A colocação permite que os usuários especifiquem regras específicas do idioma para comparação de strings, como regras para letras maiúsculas e marcas de acento.

A opção de agrupamento tem a seguinte sintaxe:

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

Ao especificar agrupamento, o campo locale é obrigatório; todos os outros campos de agrupamento são opcionais. Para obter descrições dos campos, consulte Documento de agrupamento.

Se você especificar uma ordenação no nível da collection:

• Os índices dessa coleção serão criados com esse agrupamento, a menos que a operação de criação de índice especifique explicitamente um agrupamento diferente.

• As operações nessa coleção usam o padrão da coleção a menos que eles especifiquem explicitamente um agrupamento diferente.

  Você não pode especificar vários agrupamentos para uma operação. Por exemplo, você não pode especificar agrupamentos diferentes por campo ou, se estiver realizando uma busca com uma classificação, não poderá usar um agrupamento para a busca e outro para a classificação.

Se nenhum agrupamento for especificado para a coleção ou para as operações, o MongoDB usa a comparação binária simples usada nas versões anteriores para comparações de strings.

Para uma coleção, você só pode especificar a coleção durante a criação da coleção. Depois de definir, você não poderá modificar o agrupamento da coleção.

Para ver um exemplo, consulte Especificar agrupamento.

Opcional. Um documento que expressa a write concern para a operação. Omitir para usar a função de gravação padrão.

Quando emitido em um cluster fragmentado, mongos converte a preocupação de gravação do comando create e seu auxiliar db.createCollection() em "majority".