$concat (Concatenar Strings)
Última atualização: 2026-10-09
$concat (Concatenar Strings)
$concat une duas ou mais strings (ou expressões que resultam em strings) em uma única string. É o operador de string mais comum em expressões de agregação, usado para combinar nomes, montar endereços ou construir rótulos de saída. Se qualquer argumento for null ou estiver ausente, $concat retorna null.
| Categoria | String |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $concat: [ <expressão1>, <expressão2>, ... ] }⚙️ Parâmetros
| expressão | Strings ou expressões que resolvam para strings; pelo menos duas. |
|---|
Retorno：A string concatenada; null se qualquer argumento for null
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $concat: unir primeiro e último nome
db.users.aggregate([
{ $project: {
fullName: { $concat: [ "$firstName", " ", "$lastName" ] }
} }
])Saída：
{ "_id": 1, "fullName": "Alice Johnson" }
{ "_id": 2, "fullName": "Bob Smith" }📌 Notas
- Qualquer argumento null ou ausente resulta em null (proteja com $ifNull)
- $concat aceita apenas strings; converta números com $toString antes
- A string vazia "" é um argumento válido e não resulta em null
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO $concat consegue unir números?
ANão diretamente — ele gera erro. Converta números para strings com $toString ou $convert antes.
QO que acontece se um campo for null ou estiver ausente na concatenação?
ASe qualquer operando for null ou estiver ausente, $concat retorna null (sem erro, sem pular). Envolva os operandos com $ifNull para fornecer valores alternativos.
QO $concat consegue unir arrays?
ANão. $concat aceita apenas strings; use $concatArrays para arrays e $mergeObjects para objetos.
