1.er valor no vacío de la lista.
| Campo | Valor |
|---|---|
| Categoría | Lógica |
| Tipo | Escalar (opera valor por valor) |
| Aridad | 2 o más argumentos |
| Se compila a SQL (columna calculada) | Sí |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: COALESCE. Alias aceptados (sin distinguir mayúsculas/minúsculas): primeiro.
Sintaxis#
COALESCE(expr; arg2; …)Todos los argumentos son expresiones.
Retorno#
El 1.er valor no vacío de la lista (mantiene el tipo).
Tratamiento de nulos#
Salta los vacíos y devuelve el 1.er valor no vacío; si todo está vacío, devuelve vacío.
Contexto de evaluación#
Escalar — se evalúa sobre el resultado de los argumentos (en las columnas calculadas, se ejecuta fila por fila).
Diferencias con DAX#
- Equivalente en DAX: COALESCE
- Compatibilidad: Compatible con DAX
- Observación: Primer valor no vacío de la lista.
Ejemplos#
COALESCE(desconto; 0)Ejemplo con valores#
Entrada: 1 / 0 (vacío) y alternativa 99.
COALESCE(1 / 0; 99) → 99Resultado esperado: 99
Ejemplo de negocio#
Rellenar un descuento ausente con 0 en lugar de dejarlo vacío.
Errores comunes#
Errores de escritura en el nombre de una columna, un tipo incompatible o un argumento inválido se convierten en un mensaje claro (pt-BR) — el motor nunca devuelve un número incorrecto en silencio.