Compartir a través de


Funciones de tabla

Estas funciones crean y manipulan valores de tabla.

Construcción de tabla

Nombre Descripción
#table Crea un valor de tabla a partir de columnas y filas.
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 Un nodo del árbol de sintaxis abstracta (AST) que representa la fila en una expresión de fila.
Table.FromColumns Crea una tabla a partir de una lista de columnas y valores especificados.
Table.FromList Convierte una lista en una tabla aplicando la función de división especificada a cada elemento de la lista.
Table.FromRecords Convierte una lista de registros en una tabla.
Table.FromRows Crea una tabla a partir de una lista de valores de fila y columnas opcionales.
Table.FromValue Crea una tabla con una columna a partir del valor o valores proporcionados.
Table.WithErrorContext Esta función está pensada solo para uso interno.
Table.View Crea o extiende una tabla con controladores definidos por el usuario para las operaciones de consulta y acción.
Table.ViewError Crea un registro de error modificado que no desencadenará una falla cuando sea lanzado por un controlador definido en una vista a través de Table.View.
Table.ViewFunction Crea una función que puede ser interceptada por un manejador definido en una vista (a través de Table.View).

Conversiones

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

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 la tabla.
Table.IsEmpty Indica si la tabla contiene filas.
Table.PartitionValues Devuelve información sobre cómo se particiona una tabla.
Table.Profile Devuelve un perfil de las columnas de una tabla.
Table.RowCount Devuelve el número de filas de la tabla.
Table.Schema Devuelve una tabla que contiene una descripción de las columnas (es decir, el esquema) de la tabla especificada.
Tables.GetRelationships Obtiene las relaciones entre un conjunto de tablas.

Operaciones de fila

Nombre Descripción
Table.AlternateRows Mantiene el desplazamiento inicial y luego alterna entre tomar y omitir las filas siguientes.
Table.Combine Devuelve una tabla que es el resultado de combinar una lista de tablas.
Table.FindText Devuelve todas las filas que contienen el texto especificado en la tabla.
Table.First Devuelve la primera fila o un valor predeterminado especificado.
Table.FirstN Devuelve las primeras filas de recuento especificadas.
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 un conjunto de tablas con particiones.
Table.InsertRows Inserta una lista de filas en la tabla en la posición especificada.
Table.Last Devuelve la última fila o un valor predeterminado especificado.
Table.LastN Devuelve el último número especificado de filas.
Table.MatchesAllRows Indica si todas las filas de la tabla cumplen la condición especificada.
Table.MatchesAnyRows Indica si alguna de las filas de la tabla cumple la condición especificada.
Table.Partition Divide la tabla en una lista de tablas en función del número de grupos y columnas especificados.
Table.Range Devuelve las filas que comienzan en el desplazamiento especificado.
Table.RemoveFirstN Devuelve una tabla con el número especificado de filas quitadas de la tabla a partir de la primera fila.
Table.RemoveLastN Devuelve una tabla con el número especificado de filas quitadas de la tabla a partir de la última fila.
Table.RemoveRows Quita el número especificado de filas.
Table.RemoveRowsWithErrors Devuelve una tabla con las filas quitadas de la tabla de entrada que contienen un error en al menos una de las celdas. Si se especifica una lista de columnas, solo se inspeccionan las celdas de las columnas especificadas para detectar errores.
Table.Repeat Repite las filas de las tablas un número especificado de veces.
Table.ReplaceRows Reemplaza el intervalo especificado de filas por la fila o filas proporcionadas.
Table.ReverseRows Devuelve una tabla con las filas en orden inverso.
Table.SelectRows Selecciona las filas que cumplen la función condicional.
Table.SelectRowsWithErrors Devuelve una tabla con solo las filas de la tabla de entrada que contienen un error en al menos una de las celdas. Si se especifica una lista de columnas, solo se inspeccionan las celdas de las columnas especificadas para detectar errores.
Table.SingleRow Devuelve una única fila de la tabla.
Table.Skip Devuelve una tabla con el primer número especificado de filas omitidas.
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 una columna especificada de datos de la tabla como una lista.
Table.ColumnNames Devuelve los nombres de columna como una lista.
Table.ColumnsOfType Devuelve una lista con los nombres de las columnas que coinciden con los tipos especificados.
Table.DemoteHeaders Degrada los encabezados de columna a la primera fila de valores.
Table.DuplicateColumn Duplica una columna con el nombre especificado. Los valores y el tipo se copian de la columna de origen.
Table.HasColumns Indica si la tabla contiene la columna o columnas especificadas.
Table.Pivot Dado un par de columnas que representan pares de atributo-valor, convierte los datos de la columna de atributos a encabezados de columna.
Table.PrefixColumns Devuelve una tabla donde todas las columnas se han prefijado con el texto especificado.
Table.PromoteHeaders Promueve la primera fila de valores como encabezados de columna nuevos (es decir, como nombres de columna).
Table.RemoveColumns Quita las columnas especificadas.
Table.ReorderColumns Devuelve una tabla con las columnas en el orden especificado.
Table.RenameColumns Devuelve una tabla con las columnas cuyo nombre se ha cambiado según se especifica.
Table.SelectColumns Devuelve una tabla con solo las columnas especificadas.
Table.TransformColumnNames Transforma los nombres de columna mediante la función especificada.
Table.Unpivot Convierte un conjunto de columnas de una tabla en pares de valor de atributo.
Table.UnpivotOtherColumns Convierte todas las columnas distintas de un conjunto especificado en pares de atributo-valor.

Transformación

Nombre Descripción
Table.AddColumn Agrega una columna con el nombre especificado. El valor se calcula mediante la función de selección especificada con cada fila tomada como entrada.
Table.AddFuzzyClusterColumn Agrega una nueva columna con valores representativos obtenidos por valores de agrupación aproximadas de la columna especificada en la tabla.
Table.AddIndexColumn Anexa una columna con valores de posición explícitos.
Table.AddJoinColumn Realiza una combinación entre tablas en las columnas proporcionadas y genera el resultado de combinación en una nueva columna.
Table.AddKey Agrega una clave a una tabla.
Table.AggregateTableColumn Agrega una columna de tablas a varias columnas de la tabla contenedora.
Table.CombineColumns Combina las columnas especificadas en una nueva columna mediante la función de combinador especificada.
Table.CombineColumnsToRecord Combina las columnas especificadas en una nueva columna con valores de registro donde cada registro tiene nombres de campo y valores correspondientes a los nombres de columna y los valores de las columnas que se combinaron.
Table.ConformToPageReader Esta función está pensada solo para uso interno.
Table.ExpandListColumn Dada una columna de listas de una tabla, cree una copia de una fila para cada valor de su 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 que contiene tablas en varias columnas dentro de la tabla contenedora.
Table.FillDown Propaga el valor de una celda anterior a las celdas con valores NULL siguientes en la columna.
Table.FillUp Propaga el valor de una celda a las celdas con valores NULL anteriores en la columna.
Table.FilterWithDataTable Esta función está pensada solo para uso interno.
Table.FuzzyGroup Agrupa las filas de la tabla en función de la coincidencia aproximada de claves.
Table.FuzzyJoin Combina las filas de las dos tablas que tienen una coincidencia aproximada en función de las claves especificadas.
Table.FuzzyNestedJoin Realiza una combinación aproximada entre tablas en columnas proporcionadas y genera el resultado de combinación en una nueva columna.
Table.Group Agrupa las filas de la tabla que tienen la misma clave.
Table.Join Combina las filas de las dos tablas que coinciden en función de las claves especificadas.
Table.Keys Devuelve las claves de la tabla especificada.
Table.NestedJoin Realiza una combinación entre tablas en las columnas proporcionadas y genera el resultado de combinación en una nueva columna.
Table.ReplaceErrorValues Reemplaza los valores de error de las columnas especificadas por el valor especificado correspondiente.
Table.ReplaceKeys Reemplaza las claves de la tabla especificada.
Table.ReplaceRelationshipIdentity Esta función está pensada solo para uso interno.
Table.ReplaceValue Reemplaza un valor por otro en las columnas especificadas.
Table.Split Divide la tabla especificada en una lista de tablas con el tamaño de página especificado.
Table.SplitColumn Divide la columna especificada en un conjunto de columnas adicionales mediante la función divisora especificada.
Table.TransformColumns Transforma los valores de una o varias columnas.
Table.TransformColumnTypes Aplica transformaciones de tipo del formulario { columna, tipo } mediante una referencia cultural específica.
Table.TransformRows Transforma las filas de la tabla mediante la función de transformación especificada.
Table.Transpose Convierte las columnas en filas y filas en columnas.

Membresía

Nombre Descripción
Table.Contains Indica si el registro especificado aparece como una fila en la tabla.
Table.ContainsAll Indica si todos los registros especificados aparecen como filas en la tabla.
Table.ContainsAny Indica si alguno de los registros especificados aparece como filas en la tabla.
Table.Distinct Quita las filas duplicadas de la tabla.
Table.IsDistinct Indica si la tabla solo contiene filas distintas (sin duplicados).
Table.PositionOf Devuelve la posición o las posiciones de la fila dentro de la tabla.
Table.PositionOfAny Devuelve la posición o las posiciones de cualquiera de las filas especificadas dentro de la tabla.
Table.RemoveMatchingRows Quita todas las apariciones de las filas especificadas de la tabla.
Table.ReplaceMatchingRows Reemplaza todas las filas especificadas por la fila o filas proporcionadas.

Pedido

Nombre Descripción
Table.AddRankColumn Anexa una columna con la clasificación de una o más columnas.
Table.Max Devuelve la fila más grande o el valor predeterminado mediante los criterios especificados.
Table.MaxN Devuelve la fila o las filas más grandes mediante los criterios especificados.
Table.Min Devuelve la fila más pequeña o un valor predeterminado mediante los criterios especificados.
Table.MinN Devuelve la fila o filas más pequeñas mediante los criterios especificados.
Table.Sort Ordena la tabla con uno o varios nombres de columna y criterios de comparación.

Otros

Nombre Descripción
Table.Buffer Almacena en búfer una tabla en memoria, aislándola de los cambios externos durante la evaluación.
Table.StopFolding Impide que se ejecuten operaciones posteriores en la fuente original de los datos.

Valores de parámetros

Asignar nombres a columnas de salida

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

Criterios de comparación

El criterio de comparación se puede proporcionar como cualquiera de los siguientes valores:

  • Valor numérico para especificar un criterio de ordenación. Más información: Criterio de ordenación

  • Para calcular una clave que se va a usar para ordenar, 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 devuelve -1, 0 o 1 dada la relación entre las entradas izquierda y derecha. Value.Compare se puede usar para delegar esta lógica.

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

Criterios de recuento o de condicionalidad

Este criterio se usa generalmente en operaciones de ordenación o fila. Determina el número de filas devueltas en la tabla y puede tomar dos formas, un número o una condición.

  • Un número indica cuántos valores se van a devolver en línea con la función adecuada.

  • Si se especifica una condición, se devuelven las filas que contienen valores que cumplen inicialmente la condición. Una vez que se produce un error en un valor de la condición, no se tienen en cuenta otros valores.

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

Manejo de valores adicionales

Los valores adicionales se usan para indicar cómo la función debe controlar valores adicionales en una fila. Este parámetro se especifica como un número, que se asigna a las siguientes opciones:

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

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

Falta el control de columnas

Este parámetro se usa para indicar cómo la función debe controlar las columnas que faltan. Este parámetro se especifica como un número, que se asigna a las siguientes opciones:

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

La 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 siguientes opciones:

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 como:

  • Un valor de función que es uno de los siguientes:

    • Selector de claves que determina la columna de la tabla para aplicar los criterios de igualdad.

    • Función del comparador que se usa para especificar el tipo de comparación que se va a aplicar. Se pueden especificar funciones de comparador integradas. Más información: Funciones de comparador

  • Lista de las columnas de la tabla para aplicar los criterios de igualdad.

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