Funciones de tabla

  • Artículo

Estas funciones crean y manipulan valores de tabla.

Construcción de tablas

Nombre Descripción
ItemExpression.From Devuelve el árbol de sintaxis abstracta (AST) para el cuerpo de una función.
ItemExpression.Item Nodo de árbol de sintaxis abstracta (AST) que representa el elemento en una expresión de elemento.
RowExpression.Column Devuelve un árbol de sintaxis abstracta (AST) que representa el acceso a una columna dentro de una expresión de fila.
RowExpression.From Devuelve el árbol de sintaxis abstracta (AST) para el cuerpo de una función.
RowExpression.Row Nodo de árbol de sintaxis abstracta (AST) que representa la fila de una expresión de fila.
Table.FromColumns Devuelve una tabla a partir de una lista que contiene listas anidadas con nombres y valores de columna.
Table.FromList Convierte una lista en una tabla aplicando la función de división especificada a cada elemento de la lista.
Table.FromRecords Devuelve una tabla a partir de una lista de registros.
Table.FromRows Crea una tabla a partir de una lista en la que cada elemento es una lista interna que contiene los valores de columna de una sola fila.
Table.FromValue Devuelve una tabla con una columna que contiene el valor o la lista de valores proporcionados.
Table.FuzzyGroup Agrupa las filas de una tabla estableciendo la coincidencia parcial de los valores en la columna especificada para cada fila.
Table.FuzzyJoin Combina las filas de las dos tablas que coinciden de forma aproximada en función de las claves facilitadas.
Table.FuzzyNestedJoin Realiza una combinación parcial de las tablas en las columnas proporcionadas y genera el resultado de la combinación en una nueva columna.
Table.Split Divide la tabla especificada en una lista de tablas usando el tamaño de página especificado.
Table.WithErrorContext Esta función es solamente para uso interno.
Table.View Crea o amplía una tabla con controladores definidos por el usuario para operaciones de consulta y acción.
Table.ViewError Crea un registro de error modificado que no desencadenará una reserva cuando lo inicie un controlador definido en una vista (mediante Table.View).
Table.ViewFunction Crea una función que un controlador definido en una vista (mediante Table.View) puede interceptar.

Conversiones

Nombre Descripción
Table.ToColumns Devuelve una lista de listas anidadas en la que cada una representa una columna de valores de la tabla de entrada.
Table.ToList Devuelve una tabla en una lista aplicando la función de combinación especificada a cada fila de valores de una tabla.
Table.ToRecords Devuelve una lista de registros a partir de una tabla de entrada.
Table.ToRows Devuelve una lista anidada de valores de fila a partir de una tabla de entrada.

Información

Nombre Descripción
Table.ApproximateRowCount Devuelve el número aproximado de filas de la tabla.
Table.ColumnCount Devuelve el número de columnas de una tabla.
Table.IsEmpty Devuelve true si la tabla no contiene ninguna fila.
Table.Profile Devuelve un perfil de las columnas de una tabla.
Table.RowCount Devuelve el número de filas de una tabla.
Table.Schema Devuelve una tabla que contiene una descripción de las columnas (por ejemplo, su esquema) de la tabla especificada.
Tables.GetRelationships Devuelve las relaciones entre un conjunto de tablas.

Operaciones de fila

Nombre Descripción
Table.AlternateRows Devuelve una tabla que contiene un patrón alterno de las filas de una tabla.
Table.Combine Devuelve una tabla que es el resultado de combinar una lista de tablas. Todas las tablas deben tener la misma estructura de tipo de fila.
Table.FindText Devuelve una tabla solo con las filas que contienen el texto especificado en una de sus celdas o en cualquier otra parte.
Table.First Devuelve la primera fila de una tabla.
Table.FirstN Devuelve las primeras filas de una tabla en función del parámetro countOrCondition.
Table.FirstValue Devuelve la primera columna de la primera fila de la tabla o un valor predeterminado especificado.
Table.FromPartitions Devuelve una tabla que es el resultado de combinar en columnas nuevas un conjunto de tablas divididas en particiones. Es posible especificar el tipo de la columna. El valor predeterminado es "any".
Table.InsertRows Devuelve una tabla con una lista de filas insertada en ella mediante un índice. Cada fila que se va a insertar debe coincidir con el tipo de fila de la tabla.
Table.Last Devuelve la última fila de una tabla.
Table.LastN Devuelve las últimas filas de una tabla en función del parámetro countOrCondition.
Table.MatchesAllRows Devuelve true si todas las filas de una tabla cumplen una condición.
Table.MatchesAnyRows Devuelve true si alguna de las filas de una tabla cumple una condición.
Table.Partition Divide la tabla en una lista de grupos, es decir, en cierto número de tablas, basándose en una función hash y en el valor de la columna de cada fila. La función hash se aplica al valor de columna de una fila para obtener un valor hash para esta última. El valor "groups" del módulo hash determina en qué tablas devueltas se colocará la fila.
Table.PartitionValues Devuelve información acerca de cómo se ha dividido una tabla en particiones.
Table.Range Devuelve el número especificado de filas de una tabla a partir de un desplazamiento.
Table.RemoveFirstN Devuelve una tabla con el número especificado de filas que se han quitado de otra tabla a partir de su primera fila. El número de filas quitadas depende del parámetro countOrCondition opcional.
Table.RemoveLastN Devuelve una tabla con el número especificado de filas que se han quitado de otra tabla a partir de su última fila. El número de filas quitadas depende del parámetro countOrCondition opcional.
Table.RemoveRows Devuelve una tabla con el número especificado de filas que se han quitado de otra tabla a partir de un desplazamiento.
Table.RemoveRowsWithErrors Devuelve una tabla con todas las filas quitadas de otra tabla que contienen un error al menos en una de sus celdas.
Table.Repeat Devuelve una tabla que contiene las filas que se repiten en una tabla el número de veces especificado por "count".
Table.ReplaceRows Devuelve una tabla en la que se reemplaza cierto número de filas de la tabla de entrada a partir de un desplazamiento por las filas proporcionadas.
Table.ReverseRows Devuelve una tabla con las filas en orden inverso.
Table.SelectRows Devuelve una tabla que contiene solo las filas que coinciden con una condición.
Table.SelectRowsWithErrors Devuelve una tabla solo con las filas de otra tabla que contienen un error al menos en una de sus celdas.
Table.SingleRow Devuelve una sola fila de una tabla.
Table.Skip Devuelve una tabla que no contiene la primera o las primeras filas de otra tabla.
Table.SplitAt Devuelve una lista que contiene las primeras filas de recuento especificadas y las filas restantes.

Operaciones de columna

Nombre Descripción
Table.Column Devuelve los valores de la columna de una tabla.
Table.ColumnNames Devuelve los nombres de las columnas de una tabla.
Table.ColumnsOfType Devuelve una lista con los nombres de las columnas que coinciden con los tipos especificados.
Table.DemoteHeaders Convierte la fila de encabezado en la primera fila de una tabla.
Table.DuplicateColumn Duplica una columna con un nombre especificado. Los valores y el tipo se copian de la columna de origen.
Table.HasColumns Indica si la tabla contiene las columnas especificadas.
Table.Pivot A partir de la columna de atributos de una tabla que contiene valores pivotValues, crea nuevas columnas para cada uno de los valores dinámicos y les asigna valores de valueColumn. Se puede proporcionar una función aggregationFunction opcional para controlar las repeticiones del mismo valor de clave en la columna de atributos.
Table.PrefixColumns Devuelve una tabla donde todas las columnas tienen como prefijo un valor de texto.
Table.PromoteHeaders Convierte la primera fila de la tabla en encabezados o nombres de columna.
Table.RemoveColumns Devuelve una tabla sin una o varias columnas específicas.
Table.ReorderColumns Devuelve una tabla con columnas específicas en un orden concreto.
Table.RenameColumns Devuelve una tabla con los nombres de las columnas cambiados por los nuevos nombres especificados.
Table.SelectColumns Devuelve una tabla que contiene solo columnas específicas.
Table.TransformColumnNames Transforma los nombres de las columnas mediante la función especificada.
Table.Unpivot Transforma las columnas de una lista de columnas de tabla en pares de atributo-valor.
Table.UnpivotOtherColumns Convertir todas las columnas que no formen parte de un conjunto específico en pares de atributo-valor combinados con el resto de valores de cada fila.

Transformación

Nombre Descripción
Table.AddColumn Agrega una columna denominada newColumnName a una tabla.
Table.AddFuzzyClusterColumn Agrega una columna nueva con valores representativos que obtienen los valores de agrupación aproximada de la columna especificada en la tabla.
Table.AddIndexColumn Devuelve una tabla que tiene una nueva columna con un nombre específico y que, para cada fila, contiene un índice de las filas de la tabla.
Table.AddJoinColumn Realiza una combinación anidada entre la tabla 1 y la tabla 2 a partir de columnas específicas y presenta el resultado de la combinación como una columna newColumnName para cada fila de la tabla 1.
Table.AddKey Agrega una clave a la tabla.
Table.AggregateTableColumn Agrega las tablas anidadas en una columna específica a varias columnas que contienen valores agregados para esas tablas.
Table.CombineColumns Table.CombineColumns combina columnas mediante una función de combinador para generar una nueva columna. Table.CombineColumns es la función inversa a Table.SplitColumns.
Table.CombineColumnsToRecord Combina las columnas especificadas en una nueva con valores de registro donde cada registro tiene nombres y valores de campo correspondientes a los nombres y valores de columna de aquellas que se han combinado.
Table.ConformToPageReader Esta función es solamente para uso interno.
Table.ExpandListColumn A partir de una columna con listas de una tabla, crea una fila para cada valor de la lista.
Table.ExpandRecordColumn Expande una columna de registros en columnas con cada uno de los valores.
Table.ExpandTableColumn Expande una columna de registros o una columna de tablas en varias columnas en la tabla contenedora.
Table.FillDown Reemplaza los valores NULL de la columna o columnas especificadas de la tabla por el valor más reciente de la columna que no es NULL.
Table.FillUp Devuelve una tabla a partir de otra tabla especificada, en la que el valor de la celda siguiente se propaga a las celdas superiores con valor NULL de las columnas determinadas.
Table.FilterWithDataTable Esta función es solamente para uso interno.
Table.Group Agrupa las filas de la tabla por los valores de las columnas de clave de cada fila.
Table.Join Combina las filas de la tabla 1 con las filas de la tabla 2 basándose en la igualdad de los valores de las columnas de clave seleccionados por la clave 1 para la tabla 1 y la clave 2 para la tabla 2.
Table.Keys Devuelve las claves de la tabla especificada.
Table.NestedJoin Combina las filas de las tablas en función de la igualdad de las claves. Los resultados se introducen en una nueva columna.
Table.ReplaceErrorValues Reemplaza los valores de error en las columnas especificadas por el valor correspondiente que se ha proporcionado.
Table.ReplaceKeys Reemplaza las claves de la tabla especificada.
Table.ReplaceRelationshipIdentity Esta función es solamente para uso interno.
Table.ReplaceValue Reemplaza oldValue con newValue en columnas específicas de una tabla mediante la función de reemplazo proporcionada, como text.Replace o Value.Replace.
Table.SplitColumn Devuelve un nuevo conjunto de columnas a partir de una sola columna aplicando una función de separación a cada valor.
Table.TransformColumns Transforma los valores de una o varias columnas.
Table.TransformColumnTypes Transforma los tipos de columna de una tabla mediante un tipo.
Table.TransformRows Transforma las filas de una tabla mediante una función.
Table.Transpose Devuelve una tabla con columnas convertidas en filas y filas convertidas en columnas a partir de la tabla de entrada.

Pertenencia

Nombre Descripción
Table.Contains Determina si el registro especificado aparece como una fila de la tabla.
Table.ContainsAll Determina si todos los registros especificados aparecen como filas en la tabla.
Table.ContainsAny Determina si alguno de los registros especificados aparece como filas en la tabla.
Table.Distinct Quita las filas duplicadas de una tabla para que todas las filas restantes sean distintas.
Table.IsDistinct Determina si una tabla contiene solo filas distintas.
Table.PositionOf Determina la posición o las posiciones de una fila en una tabla.
Table.PositionOfAny Determina la posición o las posiciones de alguna de las filas especificadas en la tabla.
Table.RemoveMatchingRows Quita todas las filas repetidas de una tabla.
Table.ReplaceMatchingRows Reemplaza filas específicas de una tabla por nuevas filas.

Ordenación

Nombre Descripción
Table.Max Devuelve la fila o filas de mayor valor de una tabla mediante un criterio de comparación (comparisonCriteria).
Table.MaxN Devuelve las filas de una tabla con un valor superior a un valor determinado. Una vez ordenadas las filas, se debe especificar el parámetro countOrCondition para filtrar aún más el resultado.
Table.Min Devuelve la fila o filas de menor valor de una tabla mediante un criterio de comparación (comparisonCriteria).
Table.MinN Devuelve las filas de una tabla con un valor inferior a un valor determinado. Una vez ordenadas las filas, se debe especificar el parámetro countOrCondition para filtrar aún más el resultado.
Table.AddRankColumn Anexa una columna con la clasificación de una o varias columnas.
Table.Sort Ordena las filas de una tabla mediante un criterio de comparación, comparisonCriteria, o mediante un orden predeterminado si no se especifica ninguno.

Otros

Nombre Descripción
Table.Buffer Almacena en búfer una tabla en memoria y la aísla de los cambios externos durante la evaluación.

Valores de parámetros

Asignación de nombres a las columnas de salida

Este parámetro es una lista de valores de texto que especifica los nombres de columna de la tabla resultante. Normalmente, se usa en las funciones de creación de tablas, como Table.FromRows y Table.FromList.

Criterios de comparación

El criterio de comparación se puede proporcionar de las siguientes maneras:

  • Para especificar un criterio de ordenación, se puede usar un valor numérico. Más información: Criterio de ordenación

  • Para calcular una clave que se va a usar para la ordenación, se puede usar una función de un argumento.

  • Para seleccionar una clave y un orden de control, el criterio de comparación puede ser una lista que contenga la clave y el orden.

  • Para controlar completamente la comparación, se puede usar una función de dos argumentos que devuelva -1, 0 o 1 según la relación entre las entradas izquierda y derecha. Value.Compare se puede usar para delegar esta lógica.

Para ver ejemplos, vaya a la descripción de Table.Sort.

Criterios de recuento o condición

Estos criterios se suelen usar en operaciones de ordenación o de fila. Determina el número de filas que se devuelven en la tabla y puede tomar dos formas, un número o una condición.

  • Un número indica el número de valores que se van a devolver según la función correspondiente.

  • Si se especifica una condición, se devuelven las filas con valores que cumplen inicialmente esa condición. Si un valor no cumple la condición, no se tienen en cuenta más valores.

Más información: Table.FirstN, Table.MaxN

Control de valores adicionales

Los valores adicionales se usan para indicar qué debe hacer la función con los valores adicionales de una fila. Este parámetro se especifica como un número que se asigna a las opciones siguientes:

ExtraValues.List = 0 ExtraValues.Error = 1 ExtraValues.Ignore = 2

Más información: Table.FromList, ExtraValues.Type

Control de columnas que faltan

Este parámetro se usa para indicar qué debe hacer una función si faltan columnas. Este parámetro se especifica como un número que se asigna a las opciones siguientes:

MissingField.Error = 0 MissingField.Ignore = 1 MissingField.UseNull = 2;

Este parámetro se usa en operaciones de columna o transformación, por ejemplo, en Table.TransformColumns. Más información: MissingField.Type

Criterio de ordenación

El criterio de ordenación se usa para indicar cómo se deben ordenar los resultados. Este parámetro se especifica como un número que se asigna a las opciones siguientes:

Order.Ascending = 0 Order.Descending = 1

Más información: Order.Type

Criterios de ecuación

Los criterios de ecuación para las tablas se pueden especificar de las siguientes maneras:

  • Un valor de función que es:

    • Un selector de claves que determina la columna de la tabla en la que se aplicarán los criterios de ecuación.

    • O bien, una función de comparador que se usa para especificar el tipo de comparación que se aplicará. Se pueden especificar funciones de comparador integradas. Más información: Funciones de comparador

  • Una lista de las columnas de la tabla en las que se aplicarán los criterios de ecuación.

Para ver ejemplos, vaya a la descripción de Table.Distinct.