Referencia de funciones MDX (MDX)

Microsoft SQL Server 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. Esta sección proporciona información sobre las funciones de MDX incluidas en Analysis Services.

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 elemento del mismo nivel de los descendientes de un nivel especificado, opcionalmente en el 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 de 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 corte en la recta de regresión, y = ax + b.

LinRegPoint (MDX)

Calcula la regresión lineal de un conjunto y devuelve el valor de y en la recta 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 recta de regresión, y = ax + b.

LinRegVariance (MDX)

Calcula la regresión lineal de un conjunto y devuelve la varianza asociada a la recta 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 rango (con base uno) de una tupla especificada en un conjunto especificado.

RollupChildren (MDX)

Devuelve un valor generado mediante el resumen 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 de 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. Alternativamente, esta función aumenta el detalle de 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 que están 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 de 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 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 Quarter en la dimensión de tiempo.

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 de 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 que un miembro determinado, empezando por el primer miembro del mismo nivel y acabando por el miembro en cuestión, de acuerdo con la restricción del 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 de 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 de MDX que corresponde a una 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 los miembros All de cada jerarquía de atributo de un cubo, dimensión o tupla.

StrToTuple (MDX)

Devuelve la tupla especificada por una cadena con formato de MDX.

Otras funciones

Función

Descripción

Error (MDX)

Genera un error y puede, opcionalmente, proporcionar un mensaje de error especificado.

Vea también

Conceptos