Página conceptual sobre lo que pasa cuando dos tablas se vinculan: la cardinalidad (cuántas filas de cada lado), la dirección de filtro (hacia dónde se propaga el recorte) y la protección anti-fan-out (por qué el producto a veces se niega a sumar). La configuración paso a paso está en el modelo semántico; aquí explicamos por qué importa cada opción.
Ejemplos con el workspace sintético Comércio Aurora Ltda (aurora), tablas
vendas, produtos, clientes, filiais, calendario.
Qué es una relación#
Una relación dice que una columna de una tabla apunta a la columna
identificadora de otra: vendas.produto_id → produtos.id. Al armar el SQL, el
generador encuentra el camino de join recorriendo el grafo del modelo y emite
LEFT JOIN siempre en el sentido hecho → dimensión.
Dibujas los vínculos arrastrando en el diagrama visual del editor. Cada línea del diagrama lleva dos decisiones: cardinalidad y dirección de filtro.
Dónde está el diagrama
En edición, haz clic en Relaciones en la barra del editor (o en Datos → Diagrama). El canvas da lugar al diagrama de las tablas del modelo, y la cinta muestra:
| Grupo | Botón | Qué hace |
|---|---|---|
| Modelo | Sugerir relaciones | Sugiere vínculos según los nombres de las columnas; los aceptas uno por uno |
| Modelo | Organizar | Ordena las tarjetas de las tablas en una cuadrícula |
| Datos | Ver datos | Muestra una muestra de 100 filas de las tablas del modelo |
| Zoom | Menos · Ajustar · Más | Aleja, vuelve al 100 % y centra, o acerca |
En el propio diagrama, una línea marcada avisa cuando hay riesgo: una muestra que viola la cardinalidad declarada, una relación N-N que pide una tabla puente, o dos caminos empatados (el generador rechaza la consulta). Al seleccionar dos tablas, el diagrama destaca el camino real que usa el generador entre ellas.
Cardinalidad: qué lado es "uno" y cuál es "muchos"#
| Cardinalidad | Significado | Ejemplo Aurora |
|---|---|---|
1-N / N-1 | Uno del lado de la dimensión, muchos del lado del hecho (el caso normal). | Un produto tiene muchas vendas. |
1-1 | Una fila de cada lado. | filiais ↔ una tabla de metadatos por sucursal. |
N-N | Muchos de los dos lados — exige una tabla puente. | produtos ↔ promocoes vía produto_promocao. |
La cardinalidad no es decorativa: protege tus números.
Protección anti-fan-out (por qué a veces se rechaza la suma)
Cuando un join 1-N multiplica filas, una suma sobre el lado "uno" se
contaría varias veces. Ejemplo: filiais tiene una columna meta; si unes
filiais a vendas (una sucursal, muchas ventas) y sumas filiais.meta, la meta se
cuenta una vez por venta — inflada.
ingestia.bi detecta esa explosión de filas y bloquea la agregación afectada, con un mensaje didáctico, en lugar de entregar el total incorrecto en silencio. Es lo que Power BI resuelve pidiendo un modelado correcto; aquí es una protección automática consciente de la granularidad.
Aviso
Si una suma aparece bloqueada, el problema casi siempre es de granularidad: estás sumando una medida del lado "uno" a través de un join que la duplica. Pon la medida en el hecho con la granularidad correcta, o suma desde el lado correcto de la relación.
Dirección de filtro#
Por defecto, el filtro fluye de UNO a MUCHOS (dimensión → hecho): elegir una
categoría en produtos recorta las vendas de esa categoría. Es el comportamiento
que casi siempre quieres.
Bidireccional (opt-in)
crossFilter: "both" activa la propagación en los dos sentidos de una relación
específica. Útil cuando filtrar el hecho también tiene que recortar la dimensión — por
ejemplo, mostrar solo los productos que tuvieron ventas en el período filtrado.
Detalles importantes:
- El grafo de join no es dirigido (el SQL físico no cambia al activar "both"); lo que cambia es el grafo de filtro.
- El modelo detecta ciclos y ambigüedad de propagación y rechaza un modelo cuyo significado quedaría indefinido — nunca genera SQL ambiguo en silencio.
- Es opt-in por relación: un modelo todo en "single" no sufre ningún cambio.
Roles de relación (role-playing)#
Cuando el hecho tiene varias fechas (pedido, entrega, pago), vinculas la
misma dimensión calendario varias veces, cada vínculo con un rol
con nombre. Una relación queda activa y las demás inactivas; el visual elige el
rol ("Data do Pedido" × "Data de Entrega", es decir, fecha del pedido × fecha de entrega) sin reescribir la fórmula. Los roles del
mismo par de tablas forman un grupo que se detecta automáticamente.
Ejemplo Aurora: calendario vinculada a vendas por data_pedido (activa),
data_entrega y data_pagamento (inactivas). En el visual, cambiar de "Data do Pedido"
a "Data de Entrega" cambia el eje sin tocar las medidas.
Relación N-N mediante puente#
Una relación de muchos a muchos necesita una tabla puente con claves hacia los
dos extremos. P. ej., produtos ↔ promocoes vía produto_promocao. Al cruzar
A → puente → B, la medida del lado opuesto se deduplica (el puente se reduce a
pares distintos antes de sumar), evitando el doble conteo. Una medida que vive en el
propio puente suma directo, porque su granularidad es el puente.
Sin un puente declarado, un N-N se trata como ambiguo y se rechaza — de nuevo, el producto prefiere avisar antes que equivocarse.
Cómo elegir, en la práctica#
- ¿Dudas? Deja
1-Ndel hecho a la dimensión, dirección single. Cubre la inmensa mayoría de los casos. - Activa bidireccional solo cuando necesites recortar la dimensión por el hecho, y confirma que el editor no señaló ambigüedad.
- Usa roles cuando haya varias fechas/claves para la misma dimensión.
- Usa un puente para cualquier N-N; nunca fuerces un N-N sin él.
Límites y salvedades#
- El join físico siempre es hecho → dimensión; no hay relaciones "virtuales" en memoria.
- Tope de roles por modelo (
MAX_RELATION_ROLES). - El rendimiento del join depende del tamaño de las tablas en el datalake.
Relacionados#
- Modelo semántico
- Conceptos de modelado dimensional
- Contexto de fila y de filtro
- Tutorial: modelo estrella
- Las cintas del editor
Última revisión: 2026-10-03.