criar (comando de banco de dados)

string

O nome da nova collection ou visualização. Consulte Restrições de nomenclatura. Se você tentar criar uma collection ou visualização que já exista e fornecer opções idênticas para essa collection ou visualização existente, nenhuma ação será executada e o êxito será retornado.

booleano

Opcional. Para criar uma coleção limitada, especifique true. Se você especificar true, também deve definir um tamanho máximo no campo size.

string

Obrigatório ao criar uma coleção de série temporal. O nome do campo que contém a data em cada documento da série temporal. Os documentos em uma coleção de série temporal devem ter uma data BSON válida como valor para o timeField.

string

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 raramente devem mudar. O nome do campo especificado não pode ser _id ou o mesmo que o timeseries.timeField. O campo pode ser de qualquer tipo de dados.

Embora o campo metaField seja opcional, o uso de metadados pode melhorar a otimização da query. Por exemplo, o MongoDB cria automaticamente um índice composto nos campos metaField e timeField para novas collections. Se você não fornecer um valor para este campo, os dados serão agrupados exclusivamente com base no tempo.

string

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.

inteiro

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.

inteiro

Opcional, usado com bucketMaxSpanSeconds como alternativa a granularity. Define o número de segundos para arredondar para baixo quando o MongoDB define o carimbo de data/hora 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.

inteiro

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.

documento

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.

documento

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 o para uma collection utilizando,db.createCollection() create collModou. Por exemplo, ao usar o collMod comando:

  db.runCommand( {
     collMod: <collection>,
     changeStreamPreAndPostImages: { enabled: true }
  } )

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 create ver um exemplo nessa página, consulte Criar uma coleção com imagens prévias e posteriores do fluxo de alterações para documentos.

inteiro

Opcional. Especifique um tamanho máximo em bytes para uma coleção limitada. Uma vez que uma coleção limitada atinge seu tamanho máximo, o MongoDB remove os documentos mais antigos para abrir espaço para os novos documentos. O campo size é exigido para coleções limitadas e ignorado para outras coleções.

inteiro

Opcional. O número máximo de documentos permitidos na coleção limitada. O limite size tem precedência sobre este limite. Se uma coleção limitada atingir o limite size antes de atingir o número máximo de documentos, o MongoDB removerá os documentos antigos. Se você preferir usar o limite max, certifique-se de que o limite size, que é necessário para uma coleção limitada, seja suficiente para conter o número máximo de documentos.

documento

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 storage engine wiredTiger ao criar uma collection com db.createCollection(). Para configurar a criptografia para o storage engine WiredTiger, consulte criptografia em descanso.

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

documento

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.

• A validação ocorre durante atualizações e inserções. Os documentos existentes não passam por verificações de validação até a modificação.

• Você não pode especificar um validador para collections nos bancos de dados admin, local e config.

• Você não pode especificar um validador para collections system.* .

string

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.

string

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

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

"error"

Padrão Os documentos devem passar por validação antes que a gravação ocorra. Caso contrário, a operação de gravação falhará.

"warn"

Os documentos não precisam passar pela validação. Se o documento falhar na validação, a operação de gravação registrará a falha na validação.

documento

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.

string

O nome da collection de origem ou visualização a partir da qual criar a visualização. O nome não é o namespace completo da collection ou view; ou seja, não inclui o nome do database e implica o mesmo database da view a ser criada. Você deve criar visualizações no mesmo banco de dados que a collection de origem.

Consulte também db.createView().

array

Uma array que consiste no (s) aggregation pipeline stage(s). create cria a exibição aplicando o pipeline especificado à collection ou exibição viewOn.

Uma definição de visualização pipeline não pode incluir o estágio $out ou $merge. Essa restrição também se aplica a pipelines incorporados, como pipelines usados em estágios $lookup ou $facet.

A definição da visualização é pública; ou seja, as operações db.getCollectionInfos() e explain na exibição incluirão o pipeline que define a visualização. Dessa forma, evite se referir diretamente a campos e valores confidenciais nas definições de visualização.

Consulte também db.createView().

Especifica o agrupamento padrão para a collection ou visualizaçã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 um modo de exibição, se nenhum agrupamento for especificado, o agrupamento padrão do modo de exibição será o agrupamento de comparação binário "simples". Para uma visualização em uma collection, a visualização não herda as configurações de agrupamento da collection. Para uma visualização em outra exibição, a visualização a ser criada deve especificar as mesmas configurações de agrupamento.

Depois de criar a collection ou a visualização, você não poderá atualizar seu agrupamento padrão.

Para obter um exemplo que especifica o agrupamento padrão durante a criação de uma collection, consulte Especificar agrupamento.

documento

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, omongos converte o preocupação de create gravação do comando e seu assistente db.createCollection() "majority"em.

documento

Opcional. Um documento que configura Queryable Encryption para a coleção que está sendo criada.

Para utilizar campos criptografados em uma collection, especifique uma nova opção de configuração. Você deve ter permissões para criar e modificar uma collection para criar ou editar esta configuração.

A configuração inclui uma lista de campos e seus identificadores de chave correspondentes, tipos e queries suportadas.

encryptedFieldsConfig = {
    "fields": [
      {
        "keyId": UUID,                    // required
        "path": String,                   // path to field, required
        "bsonType": "string" | "int" ..., // required
        "queries":                        // optional
        [
          { "queryType": "equality" },
        ]
      }
    ],
    "queryPatterns": [                    // optional
       {"fieldName": queryType, "fieldName": queryType, … }
    ]
}

Para obter detalhes, consulte Tutoriais de Queryable Encryption.

any

Opcional. Um comentário fornecido pelo usuário para anexar a este comando. Depois de definido, esse comentário aparece junto com os registros desse comando nos seguintes locais:

• mensagens de log do mongod, no campo attr.command.cursor.comment.

• Saída do perfil do banco de dados, no campo command.comment.

• Saída de currentOp, no campo command.comment.

Um comentário pode ser qualquer tipo BSON válido (string, inteiro, objeto, array etc).