Notas de versão para MongoDB 8.3

8.3.5 - Em breve

Esta versão contém importantes melhorias de segurança e confiabilidade.

Problemas corrigidos:

• servidor-79980 Suporte TLS 1.3 para Windows

• servidor-83322 Os limites do índice wildcard composto voltam para [MinKey, MaxKey] quando o filtro contém campos fora do CWI

• servidor-108215 Imponha limites ao número de transações multidocumento ativas

• SERVIDOR-127346 Fazer com que a atualização da sessão tenha prioridade de admissão kExempt

• Todos os problemas do JIRA foram encerrados em 8.3.5

• 8.3.5 Registro de alterações

8.3.4 - 11 de junho de 2026

Problemas corrigidos:

• servidor-128125 Alinhe a semântica de propriedade bsonObjToArray com bsonGetImmutable

• Todos os problemas do JIRA foram encerrados em 8.3.4

• 8.3.4 Registro de alterações

8.3.3 - 9 de junho de 2026

8.3.2 - 12 maio de 2026

Problemas corrigidos:

• SERVIDOR-126021 Comportamento indefinido ao inserir dados com nomes de campo duplicados em coleções de séries temporais

• Todos os problemas do JIRA foram encerrados em 8.3.2

• 8.3.2 Registro de alterações

8.3.1 - 4 maio de 2026

Problemas corrigidos:

• SERVIDOR-121610 Garantir que as chamadas emit() em cache não sejam operacionais

• SERVIDOR-121895 Aprimorar a supressão de erros de validação

• SERVIDOR-124974 Garantir a vida útil da memória durante a análise pushdown $match

• Todos os problemas do JIRA foram encerrados em 8.3.1

• 8.3.1 Registro de alterações

8.3.0 - 4 maio de 2026

O estágio de agregação $scoreFusion está geralmente disponível

A partir do MongoDB 8.3, o estágio de agregação $scoreFusion está geralmente disponível (GA). (O estágio de agregação $rankFusion relacionado está geralmente disponível a partir do MongoDB 8.0.)

Acessando índices de elementos de array em $map, $filter e $reduce

O MongoDB 8.3 melhora o acesso aos índices dos elementos de array nas expressões de agregação $map, $filter e $reduce. Você pode usar o novo campo arrayIndexAs para definir uma variável para armazenar o índice de um elemento de array. Você também pode usar a nova variável de sistema de agregação $$IDX para acessar o índice do elemento de array atual se omitir arrayIndexAs.

Estatísticas do FTDC

A partir do MongoDB 8.3, A captura de dados de diagnóstico em tempo integral (FTDC) coleta connPoolStats métricas para processosmongod.

Saída serverStatus

serverStatus inclui os seguintes novos campos em sua saída:

• aggregate.withExtension subcampo em metrics.commands.aggregate, rastreando contagens de sucesso e falha

• shardingStatistics.databaseCriticalSectionStatistics

• shardingStatistics.collectionCriticalSectionStatistics

• shardingStatistics.databaseVersionUpdateCounters

• metrics.query.cbr

• metrics.query.cbr.choseWinningPlan

• metrics.query.cbr.count

• metrics.query.cbr.histograms

• metrics.query.cbr.histograms.micros

• metrics.query.cbr.histograms.numPlans

• metrics.query.cbr.histograms.samplingMicros

• metrics.query.cbr.micros

• metrics.query.cbr.numPlans

• metrics.query.cbr.numPlansFailedCostEstimation

• metrics.query.cbr.numPlansTiedCostEstimation

• metrics.query.cbr.samplingMicros

• metrics.ttl.deletedKeys

• metrics.ttl.durationMicros

• metrics.ttl.examinedDocuments

• metrics.ttl.examinedKeys

• metrics.extension

• metrics.extension.totalAggStageExecMicros

• metrics.extension.apiCallSuccesses

• metrics.extension.apiCallFailures

• metrics.extension.vectorSearch

• metrics.extension.vectorSearch.legacyVectorSearchUsed

• metrics.extension.vectorSearch.extensionVectorSearchUsed

• metrics.extension.vectorSearch.onViewKickbackRetries

• metrics.extension.vectorSearch.inSubpipelineKickbackRetries

• metrics.repl.network.oplogFetcherLagSeconds

• metrics.repl.network.oplogGetMoresProcessed

• queues.execution.admissions

• queues.execution.backgroundTasksDeprioritization

• queues.execution.deprioritizationGate

• queues.execution.heuristicDeprioritization

• queues.execution.heuristicDeprioritizationThreshold

• queues.execution.totalDeprioritizations

• queues.execution.usesPrioritization

• queues.execution.usesThroughputProbing

• queues.execution.nonDeprioritizable

• queues.execution.deprioritizable

• queues.execution.read.normalPriority.totalDelinquentAcquisitions

• queues.execution.read.normalPriority.totalAcquisitionDelinquencyMillis

• queues.execution.read.normalPriority.maxAcquisitionDelinquencyMillis

• queues.execution.read.lowPriority

O MongoDB 8.3 remove o campo service na saída serverStatus.

A partir do MongoDB 8.3, você pode excluir todos os campos opcionais da saída serverStatus especificando none: 1. Depois de excluir todos os campos opcionais, você pode especificar os campos que deseja incluir.

Para obter detalhes, consulte Excluir todos os campos opcionais.

Opcionalmente, você também pode especificar lockContentionMetrics: 1 no comando serverStatus para incluir lockContentionMetrics na saída.

Aprimoramentos da conversão de string

A partir do MongoDB 8.3, $toString pode converter BSON types adicionais de BSON em strings, incluindo objetos, arrays, expressões regulares, MaxKeys, MinKeys e timestamps. Para detalhes, consulte $toString.

O MongoDB 8.3 introduz o argumento base opcional para $convert para converter entre string e valores numéricos utilizando as bases 2, 8, 10 e 16. Para detalhes, consulte $convert.

Aprimoramentos da conversão de array

A partir do MongoDB 8.3, você pode converter strings que representam arrays usando $convert ou a expressão abreviada $toArray.

Você também pode converter entre binData e arrays de valores numéricos. Para obter detalhes, consulte Converter binData em array e Converter uma array de valores numéricos em binData.

Aprimoramentos da conversão de objetos

A partir do MongoDB 8.3, você pode converter strings que representam objetos usando $convert ou a expressão abreviada $toObject.

Geração de índice geoespacial

A partir do MongoDB 8.3, se um documento contiver campos de coordenadas numéricas GeoJSON e legado , a geração de índice geoespacial priorizará as coordenadas GeoJSON.

Se seus documentos contiverem valores de coordenadas numéricas legado que precedem coordenadas GeoJSON e índices existentes dependerem deste comportamento, talvez seja necessário reconstruir seus índices geoespaciais.

Esta alteração pode exigir que você reconstrua índices geoespaciais se seus documentos contiverem valores de coordenadas numéricas legado que precedem coordenadas GeoJSON e índices existentes dependerem desse comportamento. Revise as queries geoespaciais para confirmar que retornam os resultados esperados.

Remover alterações de fragmentos

A partir do MongoDB 8.3, o comando removeShard está obsoleto. Esta versão introduz quatro novos comandos para substituir removeShard e fornecer controle granular sobre o processo de drenagem e remoção de fragmentos.

• startShardDraining

• stopShardDraining

• shardDrainingStatus

• commitShardRemoval

O MongoDB fornece quatro comandos adicionais para fazer a transição de um servidor de configuração incorporado para um servidor de configuração dedicado.

• startTransitionToDedicatedConfigServer

• stopTransitionToDedicatedConfigServer

• getTransitionToDedicatedConfigServerStatus

• commitTransitionToDedicatedConfigServer

Parâmetros de limite de conexão PreAuth

O MongoDB 8.3 adiciona três novos parâmetros de servidor que limitam o consumo de recursos das conexões pré-autenticação:

• capMemoryConsumptionForPreAuthBuffers

• messageSizeErrorRateSec

• preAuthMaximumMessageSizeBytes

Parâmetro cachePressureQueryPeriodMilliseconds

O MongoDB 8.3 adiciona o parâmetro cachePressureQueryPeriodMilliseconds que define o intervalo de tempo que o MongoDB espera entre as verificações para a pressão do cache do mecanismo de armazenamento. Se o mecanismo de armazenamento estiver sob pressão de cache, o MongoDB abortará a transação mais antiga. Para ver mais detalhes, consulte cachePressureQueryPeriodMilliseconds.

Parâmetro diagnósticoDataCollectionDirectorySizeMB

O MongoDB 8.3 aumenta o valor padrão de diagnosticDataCollectionDirectorySizeMB de 200 para 500 MiB.

SobrecargaAwareServerSelectionEnabled Parameter

O MongoDB 8.3 adiciona o parâmetro overloadAwareServerSelectionEnabled, que controla se as novas tentativas que têm como alvo outros servidores no cluster evitam membros que retornaram recentemente um erro rotulado SystemOverloadedError. Você pode ativar esse parâmetro para optar pelo redirecionamento com reconhecimento de sobrecarga.

ingressRequestRateLimiterApplicationExemptions Parameter

A partir do MongoDB 8.3, o parâmetro ingressRequestRateLimiterApplicationExemptions permite especificar aplicativos para isentos da limitação da taxa de solicitação de entrada. Para ver mais detalhes, consulte ingressRequestRateLimiterApplicationExemptions.

Parâmetros e métricas do profiler de banco de dados

O MongoDB 8.3 adiciona dois parâmetros que permitem controlar o impacto que o profiler de banco de dados tem no desempenho da query:

• internalQueryGlobalProfilingLockDeadlineMs

• internalProfilingMaxAbandonedWritesPerSecondPerDb

O MongoDB 8.3 também adiciona duas métricas serverStatus relacionadas:

• profiler.totalAbandonedWrites

• profiler.dbsPastThreshold

Repetir parâmetros

MongoDB 8.3 adiciona parâmetros para configurar como os clientes internos do lado do servidor (entre mongos e mongod) recuam ao tentar novamente operações que falham devido à sobrecarga.

• defaultClientBaseBackoffMillis

• defaultClientMaxBackoffMillis

• defaultClientRetryAttempts

• shardRetryTokenBucketCapacity

• shardRetryTokenReturnRate

Código BSONObjectTooLarge para erros de upsert

A partir de 8.3, as operações de upsert que produzem um objeto BSON muito grande retornam o código de erro 10334 BSONObjectTooLarge. Em versões anteriores, as operações de upsert que produzem um objeto BSON muito grande retornam os códigos de erro 17419 ou 17420.

validar atualizações de comando

A partir de 8.3, O MongoDB não habilita mais automaticamente o campo checkBSONConformance no método db.collection.validate() quando full é true. Além disso, o método db.collection.validate() agora verifica se uma coleção não tem nenhum document que exceda 16 MB.

Nova Expressão $subtype

O MongoDB 8.3 introduz uma nova expressão $subtype para extrair o subtipo de objetos de dados binários.

Novas expressões para conversão de JSON estendida

O MongoDB 8.3 introduz novas expressões de agregação para conversão entre o formato BSON e Extended JSON (EJSON):

• $serializeEJSON - Converte valores BSON para o formato JSON estendido com wrappers de tipo. Suporta os formatos JSON estendido canônico e relaxado.

• $deserializeEJSON - Converte o formato JSON estendido de volta para valores BSON nativos.

Estas expressões podem ser combinadas com $convert para analisar strings JSON, transformar valores de JSON estendido em valores BSON nativos e converter de volta para o formato JSON.

Nova Expressão $createObjectId

A partir do MongoDB 8.3, você pode usar $createObjectId para gerar novos valores aleatórios ObjectId() em pipelines e atualizações baseadas em expressões.

Novas expressões de hash

O MongoDB 8.3 introduz duas novas expressões de agregação para gerar hashes a partir de strings UTF-8 ou dados binary:

• $hash - Gera um valor de hash BinData a partir de uma string UTF-8 ou dados binary usando MD5, SHA-256 ou XXH64.

• $hexHash - Gera um hash de string hexadecimal maiúscula a partir de uma string UTF-8 ou dados binary usando MD5, SHA-256 ou XU64.

New $meta Keyword

O MongoDB 8.3 introduz uma nova palavra-chave "searchRootDocumentId" para a expressão $meta. Você pode usar essa palavra-chave para retornar o valor _id do documento raiz para documentos incorporados no conjunto de resultados $search. Para saber mais, consulte searchRootDocumentId.

Datas pré-Era UNIX

A partir de 8.3 no MongoDB, se unit não for "millisecond" em $dateAdd ou $dateSubtract e a data de input for anterior a ISODate("1970-01-01T00:00:00Z"), o resultado será um segundo maior do que nas versões anteriores do MongoDB. Isso também afeta os resultados de agregações que executam cálculos baseados em tempo, como $setWindowFields e $densify.

Geração de índice geoespacial

O MongoDB 8.3 continua o comportamento introduzido no MongoDB 8.2. Se um document contiver campos de coordenadas numéricas GeoJSON e legado, a geração de índice geoespacial priorizará as coordenadas GeoJSON.

Se seus documentos contiverem valores de coordenadas numéricas legado que precedem coordenadas GeoJSON e índices existentes dependerem deste comportamento, talvez seja necessário reconstruir seus índices geoespaciais.

Esta alteração pode exigir que você reconstrua índices geoespaciais se seus documentos contiverem valores de coordenadas numéricas legado que precedem coordenadas GeoJSON e índices existentes dependerem desse comportamento. Revise as queries geoespaciais para confirmar que retornam os resultados esperados.

Números abaixo do normal em pipelines $convert

A partir do MongoDB 8.3, o servidor é capaz de analisar toda a faixa de todos os números de double de ponto flutuante de precisão representáveis. Isso inclui números subnormais em que o dígito mais significativo tem zeros à esquerda e o expoente tem o menor valor possível.

Para obter detalhes, consulte Números subnormais.

Limite de comprimento de caracteres para $trim, $ltrim e $rtrim

A partir do MongoDB 8.3, o comprimento da string que você fornece para chars está limitado a 4096 caracteres. Para obter detalhes, consulte Limitações $trim.

Funções de janela

A partir do MongoDB 8.3, você pode usar $mergeObjects em operações $setWindowFields.

sp.process() Opção de limite

A partir do MongoDB 8.3, sp.process() suporta o input options.limit. Após sp.process() retornar limit documentos para o seu terminal, a sessão termina.

Derramamento de pesquisa de texto no mecanismo de query

A partir do MongoDB 8.3, o mecanismo de query limita o uso de memória do estágio TextOr a 100 megabytes. O estágio TextOr processa queries$text que leem metadados de pontuação de texto. Por exemplo, TextOr processa query que classificam resultados por pontuação de texts. Se o estágio TextOr exceder esse limite:

• Se allowDiskUse for true, o estágio transmitirá resultados intermediários para o disco.

• Se allowDiskUse for false, a query falha com um erro de limite de memória excedido.

Em versões anteriores, o estágio TextOr não tinha limite de memória e consumia RAM sem restrições, arriscando erros de falta de memória (OOM).

Limite de comprimento de caracteres para $trim, $ltrim e $rtrim

A partir do MongoDB 8.3, o comprimento da string que você fornece para chars está limitado a 4096 caracteres. Para obter detalhes, consulte Limitações $trim.

As operações DDL para clusters fragmentados só podem ser executadas em mongos

A partir do MongoDB 8.3, você só pode executar operações DDL e applyOps em um mongos para todos os clusters fragmentados. Essas operações podem estar temporariamente indisponíveis durante a transição de um conjunto de réplicas para um cluster fragmentado.

findShardsOnConfigTimeoutMS Parameter

O MongoDB 8.3 adiciona o parâmetro findShardsOnConfigTimeoutMS que define o tempo limite em milissegundos para operações find em relação ao namespace config.shards. Para detalhes, consulte findShardsOnConfigTimeoutMS.

config.csrs.índices removido

O MongoDB 8.3 remove o namespace config.csrs.indexes .

2dsphereIndexVersion

A partir do MongoDB 8.3, 2dsphereIndexVersion está definido para a versão 4 por padrão.

Se você precisar fazer o downgrade da versão de compatibilidade do recurso para algo abaixo de 8.3, primeiro descartar os índices 2dsphere da versão 4.

Estatísticas de query de fragmento para queries originadas de mongos

A partir do MongoDB 8.3, os servidores de fragmento incluem queries originadas de mongos em suas estatísticas de query quando queryStats está ativado. Anteriormente, a maioria das queries encaminhadas de mongos para fragmentos não aparecia nas estatísticas de query no nível do fragmento, o que reduzia a integridade dos diagnósticos no nível do fragmento.

Conversão para clusters fragmentados

A partir do MongoDB 8.3, os conjuntos de réplicas que eram clusters anteriormente fragmentados não podem ser convertidos novamente em conjuntos de réplicas.

A conversão de um cluster fragmentado em um conjunto de réplicas preserva os metadados de fragmentação de sua implantação anterior, incluindo um document de identidade de fragmentos, que impede que ele se torne novamente um cluster fragmentado. Se você tentar uma conversão autogerenciada de volta para um cluster fragmentado, o MongoDB retornará um erro.

Para converter esses conjuntos de réplicas em clusters fragmentados, entre em contato com o Suporte técnico.

Conversão para fragmento de configuração incorporado

O MongoDB 8.3 apresenta a opção mongod --replicaSetConfigShardMaintenanceMode.

Em versões anteriores, a conversão de um conjunto de réplicas em um cluster fragmentado com um fragmento de configuração incorporado exigia que você primeiro migrasse para um cluster fragmentado com um conjunto de réplicas de servidor de configuração dedicado.

Se você reiniciar um conjunto de réplicas com as opções --replicaSetConfigShardMaintenanceMode e --configsvr, poderá converter o nó primário diretamente em um fragmento de configuração incorporado.

Para obter mais informações, consulte Converter conjunto de réplicas em um fragmento de configuração incorporado.

Formatação refineCollectionShardKey

A partir do MongoDB 8.3, refineCollectionShardKey para coleção de séries temporais aceita apenas chave de fragmento especificadas usando os campos meta lógico e de tempo da coleção. O MongoDB não suporta mais a especificação de chaves utilizando o formato de buckets subjacente.

Restrições de nomenclatura do índice

A partir do MongoDB 8.3, criar um índice com o nome de "_id_" ou especificar uma dica de "_id_" em coleções de séries temporais retorna um erro.

Restrições de nomenclatura do timeField

A partir do MongoDB 8.3, você não pode criar um timeField que comece com um caractere $.

Campos para acompanhar o uso da memória pelas queries

A partir do MongoDB 8.3, você pode usar os seguintes novos campos para rastrear o uso da memória de query:

Ambos os campos aparecem nos seguintes locais:

• Saída $currentOp (Estágio de Agregação)

• db.currentOp() saída

• Database profiler output

• Mensagens de registro

• Mensagens de log de query lentas

O campo peakTrackedMemBytes também aparece nos seguintes locais:

• Explicação de resultados

• PlanCache.list() saída

• $planCacheStats saída

A partir de 8.3, use as seguintes novas métricas em $queryStats para medir o comportamento de checkForInterrupt:

• metrics.numInterruptChecksPerSec

• metrics.overdueInterruptApproxMaxMillis

Campo de forma de query do Mongos

A partir do MongoDB 8.3, as entradas de log de query lenta têm um campo originalQueryShapeHash opcional que contém a forma de query das seguintes operações com origem em mongos :

• find

• aggregate

• count

• distinct

Logs de query em andamento lentas

O MongoDB 8.3 introduz entradas de log de query em andamento lentas. As mensagens de log em queries lentas em andamento contêm menos informações do que os logs de queries lentas padrão. O MongoDB log queries no máximo uma vez se a duração da query ultrapassar o slowOpInProgressThreshold. Você pode definir o limite com db.setProfilingLevel() ou com a nova opção de linha de comando mongod --defaultSlowInProgMS.

Clusters fragmentados

Iniciando no MongoDB 8.3, se você executar o explain() em um banco de dados que não existe em um cluster fragmentado, o estágio de execução atingirá o fim do fluxo e a operação não criará o banco de dados. Para obter mais informações sobre estatísticas de execução de fim de fluxo, consulte explain.executionStats.executionStages.isEOF.

Modo SCRAM-SHA-1 e FIPS

A partir do MongoDB 8.3, você não pode especificar SCRAM-SHA-1 para authenticationMechanisms ao mesmo tempo em que especifica mongod --tlsFIPSMode ou mongos --tlsFIPSMode.

Se você tentar especificar SCRAM-SHA-1 para authenticationMechanisms e, ao mesmo tempo, especificar --tlsFIPSMode, o servidor lançará um erro e registrará uma mensagem semelhante à seguinte:

SCRAM-SHA-1 is not allowed in FIPS mode.

Somente downgrades de versão única são suportados

O MongoDB suporta downgrades de versão única apenas em versões adjacentes. Você não pode fazer o downgrade para uma versão que esteja várias versões atrás da versão atual.

• Para qualquer versão, principal ou secundária, você pode atualizar ou fazer downgrade para seus vizinhos adjacentes. Por exemplo, você pode fazer downgrade de 8.3 para 8.2 ou atualizar de 7.0 para 8.0.

• Para todas as versões, principais ou secundárias, você pode fazer downgrade para a versão principal imediatamente anterior. Por exemplo, de 8.3 a 8.0.

• Para qualquer versão secundária, você pode atualizar para a versão imediatamente seguinte. Por exemplo, de 8.2 a 8.3.

Funcionalidades incompatíveis com versões anteriores

O MongoDB 8.3 inclui funcionalidades que não são compatíveis com versões anteriores. O downgrade do 8.3 para uma versão anterior exige que você remova dados que usam essas funcionalidades.

Para obter mais informações, consulte Funcionalidades incompatíveis com versões anteriores.