Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Javascript no lado do servidor

Importante

O Map-reduce foi descontinuado a partir do MongoDB 5.0.

O MongoDB fornece os seguintes operadores que executam a execução do lado do servidor do código JavaScript:

  • $where operador que avalia uma expressão ou função JavaScript para realizar queries por documentos.

  • $accumulator e $function operações de agregação que permitem aos usuários definir expressões de agregação personalizadas.

Você pode especificar um arquivo JavaScript (.js) para mongosh para executar o arquivo no servidor. Esta é uma boa técnica para executar o trabalho administrativo em lote. Quando você executa mongosh no servidor, conectando-se por meio da interface localhost, a conexão é rápida e com baixa latência.

Para desabilitar toda a execução do JavaScript do lado do servidor para mongod ou mongos, você pode:

Embora os métodos do lado do servidor usem JavaScript, a maioria das interações com o MongoDB não usa JavaScript, mas sim um driver idiomático na linguagem do aplicativo que está interagindo.

Consulte o método individual ou a documentação do operador para obter qualquer informação sobre concorrência. Consulte também a tabela de concorrência.

O MongoDB 6.0 atualiza o mecanismo JavaScript interno usado para expressões JavaScript, $accumulator, $function e $where do lado do servidor e do MozJS-60 para o MozJS-91. Várias funções de array e string de caracteres não padrão obsoletas que existiam no MozJS-60 são removidas no MozJS-91.

A partir do MongoDB 9.0, o JavaScript do lado do servidor não está disponível na arquitetura ppc64le. Os binários mongod e mongos para ppc64le não incluem um mecanismo JavaScript. Como resultado, as operações $where, $accumulator, $function e map-reduce falham nessa arquitetura. Você não pode habilitar o JavaScript do lado do servidor no ppc64le com uma configuração de arquivo de configuração ou uma opção de linha de comando.

Para executar essas operações, use uma implantação em uma arquitetura que inclua um mecanismo JavaScript. Você também pode reescrever as operações para usar fases do pipeline de agregação e operadores que não exigem JavaScript no lado do servidor.

A partir do MongoDB 9.0, o JavaScript do lado do servidor avalia as operações locais Date em UTC, independentemente da zona horária do hospedar mongod. Getters locais como Date.prototype.getHours(), construtores e setters locais e operações que convertem uma data em uma string usam UTC. O valor de data BSON armazenado permanece inalterado, assim como os métodos Date.prototype.getTime(), Date.prototype.toISOString() e getUTC*().

Para avaliar datas em uma zona de tempo nomeada, use um operador de data de agregação, como $hour, com um argumento timezone explícito. Evite métodos Date locais em JavaScript. Para obter orientação sobre a atualização, consulte Alterações de compatibilidade no MongoDB 9.0.

Se você usa o SELinux, qualquer operação do MongoDB que exija JavaScript no lado do servidor resulta em um erro de segfault. Para desativar a execução de JavaScript no lado do servidor, consulte Desativar JavaScript no lado do servidor.