SUBSTITUTEWITHINDEX
Se aplica a: Columna calculada Tabla calculada Medida Cálculo visual
Devuelve una tabla que representa una semicombinación izquierda de las dos tablas proporcionadas como argumentos. La semicombinación se realiza mediante columnas comunes y se determina por los nombres de columna comunes y el tipo de datos común. Las columnas que se van a combinar se reemplazan por una sola columna en la tabla devuelta, que es de tipo entero y contiene un índice. El índice es una referencia a la tabla de combinación derecha según un criterio de ordenación especificado.
Las columnas de la tabla derecha o segunda proporcionada que no existen en la tabla izquierda o primera ofrecida no se incluyen en la tabla devuelta y no se usan para combinar.
El índice comienza en 0 (basado en 0) y se incrementa en uno por cada fila adicional de la tabla de combinación derecha o segunda proporcionada. El índice se basa en el criterio de ordenación especificado para la tabla de combinación derecha o segunda.
Sintaxis
SUBSTITUTEWITHINDEX(<table>, <indexColumnName>, <indexColumnsTable>, [<orderBy_expression>, [<order>][, <orderBy_expression>, [<order>]]…])
Parámetros
Término | Definición |
---|---|
tabla | Tabla que se va a filtrar mediante una semicombinación izquierda con la tabla especificada como tercer argumento (indexColumnsTable). Esta es la tabla del lado izquierdo de la semicombinación izquierda, por lo que la tabla devuelta incluye las mismas columnas que esta tabla, salvo que todas las columnas comunes de las dos tablas se reemplazan por una sola columna de índice en la tabla devuelta. |
indexColumnName | Cadena que especifica el nombre de la columna de índice que reemplaza todas las columnas comunes de las dos tablas proporcionadas como argumentos para esta función. |
indexColumnsTable | Segunda tabla de la semicombinación izquierda. Esta es la tabla del lado derecho de la semicombinación izquierda. La función solo devuelve los valores presentes en esta tabla. Además, las columnas de esta tabla (basadas en nombres de columna) se reemplazan por una sola columna de índice en la tabla devuelta por esta función. |
orderBy_expression | Cualquier expresión DAX donde el valor de resultado se use para especificar el criterio de ordenación deseado de la tabla indexColumnsTable para generar valores de índice correctos. El criterio de ordenación especificado para la tabla indexColumnsTable define el índice de cada fila de la tabla y ese índice se usa en la tabla devuelta para representar combinaciones de valores de indexColumnsTable tal y como aparecen en la tabla proporcionada como primer argumento para esta función. |
orden | (Opcional) Valor que especifica cómo ordenar valores orderBy_expression, de forma ascendente o descendente: Valor: Desc. Valor alternativo: 0(cero)/FALSE. Ordena de forma descendente los valores de orderBy_expression. Este es el valor predeterminado si se omite el parámetro order. Valor: ASC. Valor alternativo: 1/TRUE. Clasifica en orden ascendente de orderBy_expression. |
Valor devuelto
Tabla que incluye solo los valores presentes en la tabla indexColumnsTable y que tiene una columna de índice en lugar de todas las columnas presentes (por nombre) en la tabla indexColumnsTable.
Observaciones
Esta función no garantiza ningún criterio de ordenación del resultado.
Esta función no se admite para su uso en el modo DirectQuery cuando se utiliza en columnas calculadas o en reglas de seguridad de nivel de fila (RLS).