Funciones de tabla
Estas funciones crean y manipulan valores de tabla.
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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.
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.
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
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
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
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
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.