Table.AddJoinColumn

La función Table.AddJoinColumn devuelve el resultado de realizar un join izquierdo entre dos tablas, añadiendo la tabla derecha dentro de una nueva columna.

Sintaxis

Table.AddJoinColumn(
    table1 as table,
    key1 as any,
    table2 as function,
    key2 as any,
    newColumnName as text
) as table

Parámetros
  • table1: tabla izquierda a combinar
  • key1: clave a usar en la tabla izquierda
  • table2: tabla derecha a combinar
  • key2: clave a usar en la tabla derecha
  • newColumnName: nombre de la columna en la que se añadirá la tabla derecha
Ejemplos

En este ejemplo partimos de dos tablas, la primera (la tabla izquierda) con los campos "id" y "name", y la segunda (la tabla derecha) con los campos "id" y "age". En ambos casos la columna "id" sirve de clave. El resultado es la combinación izquierda de ambas tablas incluyéndose los campos de la tabla derecha en una nueva columna. Obsérvese que el identificador 33 existe en la primera tabla pero no en la segunda:

Table.AddJoinColumn(
    Table.FromRecords(
        {
            [id = 15, name = "John"],
            [id = 21, name = "Alfonso"],
            [id = 33, name = "Marta"]
        }
    ),
    "id",
    Table.FromRecords(
        {
            [id = 15, age = 35],
            [id = 21, age = 58],
            [id = 35, age = 22]
        }
    ),
    "id",
    "new_data"
)

Table

Función M Table.AddJoinColumn

Un clic en el enlace Table nos muestra el resultado de la función:

Función M Table.AddJoinColumn

Si hacemos clic en el enlace Table correspondiente a John (cuyo identificador está presente en ambas tablas), vemos el contenido de la tabla derecha correspondiente a este id:

Función M Table.AddJoinColumn

Sin embargo, un clic en el enlace Table correspondiente a Marta (cuyo identificador solo está presente en la tabla izquierda) nos muestra una tabla vacía:

Función M Table.AddJoinColumn

Por supuesto, la información correspondiente al id 35 (presente solo en la tabla derecha) no se ha incluido en el resultado.

Categoría
Funciones de tabla
Enviado por admin el Mié, 05/08/2020 - 08:26