Referencia de funciones MDX (MDX)
Analysis Services proporciona el uso de funciones en la sintaxis de expresiones multidimensionales (MDX). Las funciones se pueden utilizar en cualquier instrucción de MDX válida y se utilizan a menudo en consultas, definiciones de resumen personalizadas y otros cálculos. En esta sección se proporciona información sobre las funciones MDX.
Puede utilizar las siguientes tablas para buscar funciones por la categoría del valor devuelto, o bien puede seleccionar una función por el nombre en la lista alfabética de la tabla de contenidos.
Funciones de matriz
| Función | Descripción |
|---|---|
| SetToArray (MDX) | Convierte uno o más conjuntos en una matriz, para usarla en funciones definidas por el usuario. |
Funciones de jerarquía
| Función | Descripción |
|---|---|
| Hierarchy (MDX) | Devuelve la jerarquía que contiene un miembro o nivel especificado. |
| Dimension (MDX) | Devuelve la dimensión que contiene un miembro, nivel o jerarquía especificado. |
| Dimensions (MDX) | Devuelve una jerarquía especificada mediante una expresión numérica o de cadena. |
Funciones de nivel
| Función | Descripción |
|---|---|
| Level (MDX) | Devuelve el nivel de un miembro. |
| Levels (MDX) | Devuelve el nivel cuya posición en una dimensión o jerarquía se especifica mediante una expresión numérica, o cuyo nombre se especifica mediante una expresión de cadena. |
Funciones lógicas
| Función | Descripción |
|---|---|
| IsAncestor (MDX) | Informa de si un miembro especificado es un antecesor de otro miembro especificado. |
| IsEmpty (MDX) | Informa de si la expresión evaluada es el valor de celda vacía. |
| IsGeneration (MDX) | Informa de si un miembro especificado es una generación especificada. |
| IsLeaf (MDX) | Informa de si un miembro especificado es un miembro hoja. |
| IsSibling (MDX) | Informa de si un miembro especificado está en el mismo nivel que otro miembro especificado. |
Funciones de miembro
| Función | Descripción |
|---|---|
| Ancestor (MDX) | Devuelve el antecesor de un miembro en un nivel o distancia especificados. |
| ClosingPeriod (MDX) | Devuelve el último elemento del mismo nivel entre los descendientes de un miembro en un nivel especificado. |
| Cousin (MDX) | Devuelve el miembro secundario con la misma posición relativa bajo un miembro primario que el miembro secundario especificado. |
| CurrentMember (MDX) | Devuelve el miembro actual de una dimensión o jerarquía especificada durante la iteración. |
| DataMember (MDX) | Devuelve el miembro de datos generados por el sistema asociado a un miembro no hoja de una dimensión. |
| DefaultMember (MDX) | Devuelve el miembro predeterminado de una dimensión o jerarquía. |
| FirstChild (MDX) | Devuelve el primer elemento secundario de un miembro. |
| FirstSibling (MDX) | Devuelve el primer elemento secundario del elemento primario de un miembro. |
| Item (Member) (MDX) | Devuelve un miembro de una tupla especificada. |
| Lag (MDX) | Devuelve el miembro que se encuentra un número especificado de posiciones antes de un miembro especificado en la dimensión del miembro. |
| LastChild (MDX) | Devuelve el último elemento secundario de un miembro especificado. |
| LastSibling (MDX) | Devuelve el último elemento secundario del elemento primario de un miembro especificado. |
| Lead (MDX) | Devuelve el miembro que se encuentra un número especificado de posiciones que siguen a un miembro especificado en la dimensión del miembro. |
| LinkMember (MDX) | Devuelve el miembro equivalente a un miembro especificado de una jerarquía especificada. |
| Members (String) (MDX) | Devuelve un miembro especificado por una expresión de cadena. |
| NextMember (MDX) | Devuelve el siguiente miembro del nivel que contiene un miembro especificado |
| OpeningPeriod (MDX) | Devuelve el primer miembro del mismo nivel entre los descendientes de un nivel especificado (opcionalmente, en un miembro especificado). |
| ParallelPeriod (MDX) | Devuelve un miembro de un periodo anterior en la misma posición relativa que el indicado. |
| Parent (MDX) | Devuelve el elemento primario de un miembro. |
| PrevMember (MDX) | Devuelve el miembro anterior en el nivel que contiene un miembro especificado. |
| StrToMember (MDX) | Devuelve el miembro especificado por una cadena con formato MDX. |
| UnknownMember (MDX) | Devuelve el miembro desconocido asociado con un nivel o miembro. |
| ValidMeasure (MDX) | Devuelve una medida válida de un cubo virtual, al forzar dimensiones no aplicables al nivel superior. |
Funciones numéricas
| Función | Descripción |
|---|---|
| Aggregate (MDX) | Devuelve un valor escalar calculado al agregar medidas o bien una expresión numérica especificada de forma opcional sobre las tuplas de un conjunto especificado. |
| Avg (MDX) | Devuelve el valor medio de las medidas o el valor medio de una expresión numérica opcional, evaluado sobre un conjunto especificado. |
| CalculationCurrentPass (MDX) | Devuelve el paso de cálculo actual de un cubo para el contexto de consulta especificado. |
| CalculationPassValue (MDX) | Devuelve el valor de una expresión MDX evaluada sobre el paso de cálculo especificado de un cubo. |
| CoalesceEmpty (MDX) | Fusiona en un número o en una cadena un valor de celda vacía, y devuelve el valor fusionado. |
| Correlation (MDX) | Devuelve el coeficiente de correlación de dos series evaluadas en un conjunto. |
| Count (Dimension) (MDX) | Devuelve el número de dimensiones de un cubo. |
| Count (niveles de jerarquía) (MDX) | Devuelve el número de niveles de una dimensión o jerarquía. |
| Count (Set) (MDX) | Devuelve el número de celdas de un conjunto. |
| Count (Tuple) (MDX) | Devuelve el número de dimensiones de una tupla. |
| Covariance (MDX) | Devuelve la covarianza de población de dos series evaluadas en un conjunto utilizando la fórmula de llenado sesgada. |
| CovarianceN (MDX) | Devuelve la covarianza de muestra de dos series evaluadas en un conjunto utilizando la fórmula de población no sesgada. |
| DistinctCount (MDX) | Devuelve el número de tuplas distintas y no vacías de un conjunto. |
| IIf (MDX) | Devuelve uno de los dos valores determinados por una prueba lógica. |
| LinRegIntercept (MDX) | Calcula la regresión lineal de un conjunto y devuelve el valor de la interceptación en la línea de regresión, y = ax + b. |
| LinRegPoint (MDX) | Calcula la regresión lineal de un conjunto y devuelve el valor de y en la línea de regresión, y = ax + b. |
| LinRegR2 (MDX) | Calcula la regresión lineal de un conjunto y devuelve el coeficiente de determinación, R2. |
| LinRegSlope (MDX) | Calcula la regresión lineal de un conjunto y devuelve el valor de la pendiente en la línea de regresión, y = ax + b. |
| LinRegVariance (MDX) | Calcula la regresión lineal de un conjunto y devuelve la varianza asociada a la línea de regresión, y = ax + b. |
| LookupCube (MDX) | Devuelve el valor de una expresión MDX evaluada sobre otro cubo especificado en la misma base de datos. |
| Max (MDX) | Devuelve el valor máximo de una expresión numérica evaluada sobre un conjunto. |
| Median (MDX) | Devuelve el valor medio de una expresión numérica evaluada sobre un conjunto. |
| Min (MDX) | Devuelve el valor mínimo de una expresión numérica evaluada sobre un conjunto. |
| Ordinal (MDX) | Devuelve el valor ordinal (con base cero) asociado a un nivel. |
| Predict (MDX) | Devuelve un valor de una expresión numérica evaluada sobre un modelo de minería de datos. |
| Rank (MDX) | Devuelve el intervalo con base uno de una tupla especificada en un conjunto especificado. |
| RollupChildren (MDX) | Devuelve un valor generado mediante la acumulación de los valores de los elementos secundarios de un miembro especificado, utilizando el operador unario especificado. |
| Stddev (MDX) | Alias para Stdev (MDX). |
| StddevP (MDX) | Alias para StdevP (MDX). |
| Stdev (MDX) | Devuelve la desviación de muestra estándar de una expresión numérica evaluada sobre un conjunto, mediante la fórmula de población no sesgada. |
| StdevP (MDX) | Devuelve la desviación estándar de población de una expresión numérica evaluada sobre un conjunto, mediante la fórmula de población sesgada. |
| StrToValue (MDX) | Devuelve el valor especificado por una cadena con formato MDX. |
| Sum (MDX) | Devuelve la suma de una expresión numérica evaluada sobre un conjunto. |
| Value (MDX) | Devuelve el valor de una medida. |
| Var (MDX) | Devuelve la varianza de muestra de una expresión numérica evaluada en un conjunto, mediante la fórmula de población no sesgada. |
| Variance (MDX) | Alias para Var (MDX). |
| VarianceP (MDX) | Alias para VarP (MDX). |
| VarP (MDX) | Devuelve la varianza de población de una expresión numérica evaluada en un conjunto, mediante la fórmula de población sesgada. |
Funciones de conjunto
| Función | Descripción |
|---|---|
| AddCalculatedMembers (MDX) | Devuelve un conjunto generado al agregar miembros calculados a un conjunto especificado. |
| AllMembers (MDX) | Devuelve un conjunto que contiene todos los miembros de la dimensión, jerarquía o nivel especificados, incluyendo los miembros calculados. |
| Ancestors (MDX) | Devuelve un conjunto de todos los antecesores de un miembro en un nivel o distancia especificados. |
| Ascendants (MDX) | Devuelve el conjunto de antecesores de un miembro especificado, incluyendo el propio miembro. |
| Axis (MDX) | Devuelve un conjunto definido en un eje. |
| BottomCount (MDX) | Ordena un conjunto de forma ascendente y devuelve el número de tuplas especificado con los valores más bajos. |
| BottomPercent (MDX) | Ordena un conjunto de forma ascendente y devuelve un conjunto de tuplas con los valores más bajos con un total acumulado igual o inferior a un porcentaje especificado. |
| BottomSum (MDX) | Ordena un conjunto de forma ascendente y devuelve un conjunto de tuplas con los valores más bajos con un total igual o inferior a un valor especificado. |
| Children (MDX) | Devuelve el elemento secundario de un miembro especificado. |
| Crossjoin (MDX) | Devuelve el producto cruzado de uno o más conjuntos. |
| CurrentOrdinal (MDX) | Devuelve el número de iteración actual dentro de un conjunto durante la iteración. |
| Descendants (MDX) | Devuelve el conjunto de descendientes de un miembro en el nivel o distancia especificados; opcionalmente puede incluir o excluir los descendientes de otros niveles. |
| Distinct (MDX) | Devuelve un conjunto, eliminando tuplas duplicadas de un conjunto especificado. |
| DrilldownLevel (MDX) | Aumenta los detalles de los miembros de un conjunto a un nivel por debajo del nivel más bajo representado en el conjunto o un nivel por debajo del nivel especificado opcionalmente de un miembro representado en el conjunto. |
| DrilldownLevelBottom (MDX) | Aumenta el detalle de los miembros inferiores de un conjunto, de un nivel especificado a otro inferior. |
| DrilldownLevelTop (MDX) | Aumenta el detalle de los miembros superiores de un conjunto, de un nivel especificado a otro inferior. |
| DrilldownMember (MDX) | Aumenta el detalle de los miembros de un conjunto especificado presentes en un segundo conjunto especificado. Alternativamente, esta función aumenta el detalle de un conjunto de tuplas. |
| DrilldownMemberBottom (MDX) | Aumenta el nivel de detalle de miembros de un conjunto especificado que están presentes en otro conjunto especificado, lo que limita el conjunto de resultados a un número específico de miembros. Alternativamente, esta función también aumenta el detalle de un conjunto de tuplas. |
| DrilldownMemberTop (MDX) | Aumenta el nivel de detalle de miembros de un conjunto especificado que están presentes en otro conjunto especificado, lo que limita el conjunto de resultados a un número específico de miembros. Como alternativa, esta función explora en profundidad un conjunto de tuplas. |
| DrillupLevel (MDX) | Reduce el detalle de los miembros de un conjunto por debajo de un nivel especificado. |
| DrillupMember (MDX) | Reduce el detalle de los miembros de un conjunto especificado presentes en un segundo conjunto especificado. |
| Except (MDX) | Encuentra la diferencia entre dos conjuntos, reteniendo opcionalmente los duplicados. |
| Exists (MDX) | Devuelve el conjunto de miembros de un conjunto que existen con una o más tuplas de otros conjuntos. |
| Extract (MDX) | Devuelve un conjunto de tuplas a partir de elementos de dimensión extraídos. |
| Filter (MDX) | Devuelve el conjunto resultante de filtrar un determinado conjunto con una condición de búsqueda. |
| Generate (MDX) | Aplica un conjunto a cada miembro de otro conjunto y a continuación combina los conjuntos resultantes mediante unión. Alternativamente, esta función devuelve una cadena concatenada que se creó evaluando una expresión de cadena en un conjunto. |
| Head (MDX) | Devuelve el primer número de elementos especificado en un conjunto y retiene los duplicados. |
| Hierarchize (MDX) | Ordena los miembros de un conjunto en una jerarquía. |
| Intersect (MDX) | Devuelve la intersección de dos conjuntos de entrada; conservando opcionalmente los duplicados. |
| LastPeriods (MDX) | Devuelve un conjunto de miembros hasta un miembro determinado, éste inclusive. |
| Members (Set) (MDX) | Devuelve el conjunto de miembros en una dimensión, nivel o jerarquía. |
| Mtd (MDX) | Devuelve un conjunto de miembros del mismo nivel que un miembro determinado, empezando por el primer miembro del mismo nivel y acabando con el miembro en cuestión, de acuerdo con la restricción del nivel de año en la dimensión de tiempo. |
| NameToSet (MDX) | Devuelve un conjunto que contiene el miembro especificado por una cadena con formato MDX. |
| NonEmptyCrossjoin (MDX) | Devuelve el producto cruzado de uno o más conjuntos de un conjunto, excluidas las tuplas vacías o sin datos de tabla de hechos asociada. |
| Order (MDX) | Organiza los miembros de un conjunto especificado; opcionalmente preservando o rompiendo la jerarquía. |
| PeriodsToDate (MDX) | Devuelve un conjunto de miembros del mismo nivel que un miembro determinado, empezando por el primer miembro del mismo nivel y acabando con el miembro en cuestión, de acuerdo con la restricción del nivel especificado en la dimensión de tiempo. |
| Qtd (MDX) | Devuelve un conjunto de miembros del mismo nivel del mismo nivel que un miembro determinado, empezando por el primer elemento del mismo nivel y finalizando con el miembro especificado, como restringido por el nivel Quarter de la dimensión Time. |
| Siblings (MDX) | Devuelve los miembros del mismo nivel que un miembro especificado, incluyendo el propio miembro. |
| StripCalculatedMembers (MDX) | Devuelve un conjunto generado al eliminar miembros calculados de un conjunto especificado. |
| StrToSet (MDX) | Devuelve el conjunto especificado por una cadena con formato MDX. |
| Subset (MDX) | Devuelve un subconjunto de tuplas a partir de un conjunto especificado. |
| Tail (MDX) | Devuelve un subconjunto del final de un conjunto. |
| ToggleDrillState (MDX) | Alterna el estado de detalle de los miembros. |
| TopCount (MDX) | Ordena un conjunto de forma descendente y devuelve el número de elementos especificado con los valores más altos. |
| TopPercent (MDX) | Ordena un conjunto de forma descendente y devuelve un conjunto de tuplas con los valores más altos con un total acumulado igual o inferior a un porcentaje especificado. |
| TopSum (MDX) | Ordena un conjunto y devuelve los elementos de nivel superior cuyo total acumulado sea igual o superior a un valor especificado. |
| Union (MDX) | Devuelve la unión de dos conjuntos; opcionalmente conserva los duplicados. |
| Unorder (MDX) | Quita cualquier orden impuesto sobre un conjunto especificado. |
| VisualTotals (MDX) | Devuelve un conjunto que se genera calculando de forma dinámica el total de miembros secundarios de un conjunto especificado; opcionalmente puede utilizar un patrón para el nombre del miembro primario en el conjunto de celdas resultante. |
| Wtd (MDX) | Devuelve un conjunto de miembros del mismo nivel que un miembro determinado, empezando por el primer miembro del mismo nivel y acabando con el miembro en cuestión, de acuerdo con la restricción del nivel de semana en la dimensión de tiempo. |
| Ytd (MDX) | Devuelve un conjunto de miembros del mismo nivel del mismo nivel que un miembro determinado, empezando por el primer elemento del mismo nivel y finalizando con el miembro especificado, como restringido por el nivel Year de la dimensión Time. |
Funciones de cadena
| Función | Descripción |
|---|---|
| CalculationPassValue (MDX) | Devuelve el valor de una expresión MDX evaluada sobre el paso de cálculo especificado de un cubo. |
| CoalesceEmpty (MDX) | Fusiona en un número o en una cadena un valor de celda vacía, y devuelve el valor fusionado. |
| Generate (MDX) | Aplica un conjunto a cada miembro de otro conjunto y a continuación combina los conjuntos resultantes mediante unión. Alternativamente, esta función devuelve una cadena concatenada que se creó evaluando una expresión de cadena en un conjunto. |
| IIf (MDX) | Devuelve uno de los dos valores determinados por una prueba lógica. |
| LookupCube (MDX) | Devuelve el valor de una expresión MDX evaluada sobre otro cubo especificado en la misma base de datos. |
| MemberToStr (MDX) | Devuelve una cadena con formato MDX que corresponde a un miembro especificado. |
| Name (MDX) | Devuelve el nombre de una dimensión, jerarquía, nivel o miembro. |
| Properties (MDX) | Devuelve una cadena, o un valor con tipos muy marcados, que contiene un valor de propiedad de miembro. |
| SetToStr (MDX) | Devuelve una cadena con formato de MDX que corresponde a un conjunto especificado. |
| TupleToStr (MDX) | Devuelve una cadena con formato MDX que corresponde a la tupla especificada. |
| UniqueName (MDX) | Devuelve el nombre único de una dimensión, jerarquía, nivel o miembro especificado. |
| UserName (MDX) | Devuelve el nombre de dominio y el nombre de usuario de la conexión actual. |
Funciones de subcubo
| Función | Descripción |
|---|---|
| This (MDX) | Devuelve el subcubo actual. |
| Leaves (MDX) | Devuelve el conjunto de miembros hoja en la dimensión, miembro o tupla especificada. |
funciones de tupla
| Función | Descripción |
|---|---|
| Current (MDX) | Devuelve la tupla actual de un conjunto durante la iteración. |
| Item (Tuple) (MDX) | Devuelve una tupla desde un conjunto. |
| Root (MDX) | Devuelve una tupla que consta de todos los miembros de cada jerarquía de atributos de un cubo, dimensión o tupla. |
| StrToTuple (MDX) | Devuelve la tupla especificada por una cadena con formato MDX. |
Otras funciones
| Función | Descripción |
|---|---|
| Error (MDX) | Genera un error y puede, opcionalmente, proporcionar un mensaje de error especificado. |