arrayJoin toma cada fila y genera un conjunto de filas (unfold).
Esta función toma un array como argumento y expande la fila de origen en varias filas, una por cada elemento del array.
Todos los valores de las columnas se copian sin más, excepto los de la columna en la que se aplica esta función; estos se sustituyen por el valor correspondiente del array.
Si el array está vacío,
arrayJoin no genera ninguna fila.
Para devolver una sola fila que contenga el valor predeterminado del tipo de array, puede envolverlo con emptyArrayToSingle, por ejemplo: arrayJoin(emptyArrayToSingle(...)).unnest (desde la versión 26.5) es un alias de arrayJoin que no distingue entre mayúsculas y minúsculas y se usa como llamada a función (SELECT unnest(arr)). La sintaxis de PostgreSQL como fuente de tabla no es compatible (FROM unnest(...), CROSS JOIN UNNEST(...) y LATERAL). Use la cláusula ARRAY JOIN para esas consultas.
Por ejemplo:
Query
Response
arrayJoin afecta a todas las secciones de la consulta, incluida la cláusula WHERE. Observe que el resultado de la siguiente consulta es 2, aunque la subconsulta devolvió 1 fila.
Query
Response
arrayJoin, incluido a través de su alias unnest, no se permite en una condición JOIN ON que se evalúa durante el JOIN, porque dicha condición debe conservar el número de filas y se evalúa por separado para cada lote de filas del JOIN. Una condición que se aplica solo a uno de los lados, así como una clave de igualdad basada en arrayJoin, se extraen antes del JOIN y no se ven afectadas. Una condición no disyuntiva de ALL INNER JOIN tampoco se ve afectada, ya que en ese caso la condición se aplica después del JOIN. Cuando la expansión depende solo de un lado, muévala a un ARRAY JOIN en una subconsulta antes del JOIN; una condición cuyo argumento de arrayJoin lee columnas de ambos lados debe reestructurarse.
Una consulta puede usar varias funciones arrayJoin. En este caso, la transformación se realiza varias veces y las filas se multiplican.
Por ejemplo:
Query
Response
Orden de las filas
Para cada fila de origen,arrayJoin devuelve los elementos en el mismo orden en que aparecen en el array.
Si una consulta contiene más de una llamada a arrayJoin con argumentos distintos, el resultado incluye una fila por cada combinación de los elementos. El orden de estas filas no está garantizado, ya que depende del plan de consulta. Por ejemplo, si la cláusula WHERE utiliza una de las llamadas, la consulta puede expandir esa llamada en primer lugar. Para obtener un orden predecible, utilice ORDER BY:
Query
Response
ORDER BY, esta consulta puede devolver las filas en el orden ('a', 1), ('b', 1), ('a', 2), ('b', 2).
Sin ORDER BY, no se garantiza el orden de las filas de origen. Para obtener un orden estable y para paginar con LIMIT y OFFSET, consulte la sección “Orden de filas y paginación” de la cláusula ARRAY JOIN. Las reglas de ORDER BY descritas en esa sección también se aplican a arrayJoin.
Buena práctica
Usar variosarrayJoin con la misma expresión puede no producir los resultados esperados debido a la eliminación de subexpresiones comunes.
En esos casos, considere modificar las expresiones de array que se repiten con operaciones adicionales que no afecten al resultado del JOIN. Por ejemplo, arrayJoin(arraySort(arr)), arrayJoin(arrayConcat(arr, []))
Ejemplo:
Query
ARRAY JOIN en la consulta SELECT, que ofrece posibilidades más amplias.
ARRAY JOIN le permite convertir varias arrays con el mismo número de elementos a la vez.
Ejemplo:
Query
Response
Tuple
Ejemplo:
Query
Row
arrayJoin en ClickHouse proviene de su similitud conceptual con la operación JOIN, pero aplicada a arrays dentro de una sola fila. Mientras que los JOIN tradicionales combinan filas de distintas tablas, arrayJoin “une” cada elemento de un array en una fila, produciendo múltiples filas -una por cada elemento del array- mientras duplica los valores de las demás columnas. ClickHouse también proporciona la sintaxis de la cláusula ARRAY JOIN, lo que hace que esta relación con las operaciones JOIN tradicionales sea aún más explícita al usar la terminología familiar de SQL JOIN. Este proceso también se denomina “desplegar” el array, pero el término “join” se usa tanto en el nombre de la función como en la cláusula porque se asemeja a unir la tabla con los elementos del array, expandiendo efectivamente el conjunto de datos de una forma similar a una operación JOIN.