MDX-Funktionsreferenz (MDX)
Analysis Services stellt die Verwendung von Funktionen in mdx-Syntax (Multidimensional Expressions) bereit. Funktionen können in jeder gültigen MDX-Anweisung verwendet werden, z. B. in Abfragen, benutzerdefinierten Rollupdefinitionen und anderen Berechnungen. Dieser Abschnitt enthält Informationen zu den MDX-Funktionen.
In den folgenden Tabellen können Sie Funktionen anhand der Kategorie ihres Rückgabewerts finden oder eine Funktion namentlich aus der alphabetischen Liste im Inhaltsverzeichnis auswählen.
Arrayfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| SetToArray (MDX) | Konvertiert eine Menge oder mehrere Mengen in ein Array zum Verwenden in einer benutzerdefinierten Funktion. |
Hierarchiefunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| Hierarchy (MDX) | Gibt die Hierarchie zurück, die ein angegebenes Element oder eine angegebene Ebene enthält. |
| Dimension (MDX) | Gibt die Dimension zurück, die ein angegebenes Element, eine angegebene Ebene oder eine angegebene Hierarchie enthält. |
| Dimensionen (MDX) | Gibt eine Hierarchie zurück, die durch einen numerischen Ausdruck oder einen Zeichenfolgenausdruck angegeben ist. |
Ebenenfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| Level (MDX) | Gibt die Ebene eines Elements zurück. |
| Levels (MDX) | Gibt die Ebene zurück, deren Position in einer Dimension oder Hierarchie durch einen numerischen Ausdruck angegeben ist oder deren Name durch einen Zeichenfolgenausdruck angegeben ist. |
Logische Funktionen
| Funktion | BESCHREIBUNG |
|---|---|
| IsAncestor (MDX) | Gibt zurück, ob ein angegebenes Element ein Vorgänger eines anderen angegebenen Elements ist. |
| IsEmpty (MDX) | Gibt zurück, ob der ausgewertete Ausdruck dem leeren Zellenwert entspricht. |
| IsGeneration (MDX) | Gibt zurück, ob sich ein angegebenes Element in einer angegebenen Generation befindet. |
| IsLeaf (MDX) | Gibt zurück, ob ein angegebenes Element ein Blattelement ist. |
| IsSibling (MDX) | Gibt zurück, ob ein angegebenes Element ein gleichgeordnetes Element eines anderen angegebenen Elements ist. |
Elementfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| Ancestor (MDX) | Gibt den Vorgänger eines Elements in einer angegebenen Ebene oder in einem angegebenen Abstand zurück. |
| ClosingPeriod (MDX) | Gibt das letzte gleichgeordnete Element unter den nachfolgenden Werten eines Elements auf einer angegebenen Ebene zurück. |
| Cousin (MDX) | Gibt das untergeordnete Element mit derselben relativen Position unter einem übergeordneten Element wie das angegebene untergeordnete Element zurück. |
| CurrentMember (MDX) | Gibt das aktuelle Element entlang einer angegebenen Dimension oder Hierarchie während einer Iteration zurück. |
| DataMember (MDX) | Gibt das systemgenerierte Datenelement zurück, das einem Nicht-Blattelement einer Dimension zugeordnet ist. |
| DefaultMember (MDX) | Gibt das Standardelement einer Dimension oder Hierarchie zurück. |
| FirstChild (MDX) | Gibt das erste untergeordnete Element eines Elements zurück. |
| FirstSibling (MDX) | Gibt das erste untergeordnete Element für das übergeordnete Element eines Elements zurück. |
| Item (Element) (MDX) | Gibt ein Element aus einem angegebenen Tupel zurück. |
| Lag (MDX) | Gibt das Element zurück, das eine angegebene Anzahl von Positionen vor einem angegebenen Element entlang der Dimension des Elements liegt. |
| LastChild (MDX) | Gibt das letzte untergeordnete Element eines Elements zurück. |
| LastSibling (MDX) | Gibt das letzte untergeordnete Element des übergeordneten Elements eines angegebenen Elements zurück. |
| Lead (MDX) | Gibt das Element zurück, das eine angegebene Anzahl von Positionen auf ein angegebenes Element entlang der Dimension des Elements folgt. |
| LinkMember (MDX) | Gibt das Element zurück, das in einer angegebenen Hierarchie gleichbedeutend mit dem angegebenen Element ist. |
| Members (Zeichenfolge) (MDX) | Gibt ein durch einen Zeichenfolgenausdruck angegebenes Element zurück. |
| NextMember (MDX) | Gibt das nächste Element in der Ebene zurück, die ein angegebenes Element enthält. |
| OpeningPeriod (MDX) | Gibt das erste gleichgeordnete Element unter den nachfolgenden Werten einer angegebenen Ebene optional bei einem angegebenen Element zurück. |
| ParallelPeriod (MDX) | Gibt ein Element aus einer früheren Periode in derselben relativen Position wie ein angegebenes Element zurück. |
| Parent (MDX) | Gibt das übergeordnete Element eines Elements zurück. |
| PrevMember (MDX) | Gibt das vorherige Element in der Ebene zurück, die ein angegebenes Element enthält. |
| StrToMember (MDX) | Gibt den durch eine MDX-formatierte Zeichenfolge angegebenen Member zurück. |
| UnknownMember (MDX) | Gibt das einer Ebene oder einem Element zugeordnete unbekannte Element zurück. |
| ValidMeasure (MDX) | Gibt ein gültiges Measure in einem virtuellen Cube zurück, indem für nicht passende Dimensionen ihre oberste Ebene erzwungen wird. |
Numerische Funktionen
| Funktion | BESCHREIBUNG |
|---|---|
| Aggregate (MDX) | Gibt einen Skalarwert zurück, der durch Aggregieren von Measures oder eines optional angegebenen numerischen Ausdrucks über den Tupeln einer angegebenen Menge berechnet wird. |
| Avg (MDX) | Gibt den Mittelwert von Measures oder eines optionalen numerischen Ausdrucks, ausgewertet über einer angegebenen Menge, zurück. |
| CalculationCurrentPass (MDX) | Gibt den aktuellen Berechnungsdurchlauf eines Cubes für den angegebenen Abfragekontext zurück. |
| CalculationPassValue (MDX) | Gibt den Wert eines MDX-Ausdrucks zurück, der über dem angegebenen Berechnungsdurchlauf eines Cubes ausgewertet wird. |
| CoalesceEmpty (MDX) | Koaliert einen leeren Zellwert mit einer Zahl oder einer Zeichenfolge und gibt den koalierten Wert zurück. |
| Correlation (MDX) | Gibt den Korrelationskoeffizienten zweier Reihen zurück, die über einer Menge ausgewertet werden. |
| Count (Dimension) (MDX) | Gibt die Anzahl der Dimensionen in einem Cube zurück. |
| Count (Hierarchieebenen) (MDX) | Gibt die Anzahl der Ebenen in einer Dimension oder Hierarchie zurück. |
| Count (Menge) (MDX) | Gibt die Anzahl der Zellen in einer Menge zurück. |
| Count (Tupel) (MDX) | Gibt die Anzahl der Dimensionen in einem Tupel zurück. |
| Covariance (MDX) | Gibt die Kovarianz der Gesamtheiten zweier Serien zurück, die über einer Menge mithilfe der Formel für die unausgewogene Auffüllung berechnet wurde. |
| CovarianceN (MDX) | Gibt die Stichprobenkovarianz zweier Serien zurück, die über einer Menge mithilfe der Formel für die ausgewogene Auffüllung berechnet wurde. |
| DistinctCount (MDX) | Gibt die Anzahl der unterschiedlichen nicht leeren Tupel in einer Menge zurück. |
| IIf (MDX) | Gibt in Abhängigkeit von einem logischen Test einen von zwei Werten zurück. |
| LinRegIntercept (MDX) | Berechnet die lineare Regression eines Satzes und gibt den Wert des Intercept in der Regressionslinie zurück, y = ax + b. |
| LinRegPoint (MDX) | Berechnet die lineare Regression eines Satzes und gibt den Wert von y in der Regressionslinie zurück, y = ax + b. |
| LinRegR2 (MDX) | Berechnet die lineare Regression einer Menge und gibt den Bestimmungskoeffizienten, R2, zurück. |
| LinRegSlope (MDX) | Berechnet die lineare Regression eines Satzes und gibt den Wert der Steigung in der Regressionslinie zurück, y = ax + b. |
| LinRegVariance (MDX) | Berechnet die lineare Regression einer Gruppe und gibt die varianz zurück, die der Regressionslinie zugeordnet ist, y = ax + b. |
| LookupCube (MDX) | Gibt den Wert eines MDX-Ausdrucks zurück, der über einem anderen angegebenen Cube in derselben Datenbank ausgewertet wird. |
| Max (MDX) | Gibt den Maximalwert eines numerischen Ausdrucks zurück, der über einer Menge ausgewertet wird. |
| Median (MDX) | Gibt den Median eines numerischen Ausdrucks zurück, der über einer Menge ausgewertet wird. |
| Min (MDX) | Gibt den Minimalwert eines numerischen Ausdrucks zurück, der über einer Menge ausgewertet wird. |
| Ordinal (MDX) | Gibt den nullbasierten Ordinalwert, der einer Ebene zugeordnet ist, zurück. |
| Predict (MDX) | Gibt einen Wert eines numerischen Ausdrucks zurück, der über einem Data Mining-Modell ausgewertet wurde. |
| Rank (MDX) | Gibt den einsbasierten Rang eines angegebenen Tupels in einer angegebenen Menge zurück. |
| RollupChildren (MDX) | Gibt einen Wert zurück, der durch einen Rollup der Werte der untergeordneten Elemente eines angegebenen Elements mithilfe des angegebenen unären Operators generiert wird. |
| Stddev (MDX) | Alias für Stdev (MDX). |
| StddevP (MDX) | Alias für StdevP (MDX). |
| Stdev (MDX) | Gibt die Stichproben-Standardabweichung eines numerischen Ausdrucks zurück, die über einer Menge mithilfe der Formel für die ausgewogene Auffüllung berechnet wurde. |
| StdevP (MDX) | Gibt die Standardabweichung eines numerischen Ausdrucks bezüglich der Gesamtheit zurück, die über einer Menge mithilfe der Formel für die unausgewogene Auffüllung berechnet wurde. |
| StrToValue (MDX) | Gibt den Wert zurück, der durch eine MDX-formatierte Zeichenfolge angegeben wird. |
| Sum (MDX) | Gibt die Summe eines numerischen Ausdrucks zurück, der über einer Menge ausgewertet wird. |
| Value (MDX) | Gibt den Wert eines Measures zurück. |
| Var (MDX) | Gibt die Stichprobenvarianz eines numerischen Ausdrucks zurück, der über einer Menge mithilfe der Formel für die ausgewogene Auffüllung berechnet wurde. |
| Variance (MDX) | Alias für Var (MDX). |
| VarianceP (MDX) | Alias für VarP (MDX). |
| VarP (MDX) | Gibt die Varianz eines numerischen Ausdrucks zurück, die über einer Menge mithilfe der Formel für die unausgewogene Auffüllung berechnet wurde. |
Mengenfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| AddCalculatedMembers (MDX) | Gibt eine Menge zurück, die durch Hinzufügen berechneter Elemente zu einer angegebenen Menge erstellt wird. |
| AllMembers (MDX) | Gibt eine Menge zurück, die alle Elemente der angegebenen Dimension, Hierarchie oder Ebene, einschließlich berechneter Elemente, enthält. |
| Ancestors (MDX) | Gibt die Menge aller Vorgänger eines Elements in einer angegebenen Ebene oder in einem angegebenen Abstand zurück. |
| Ascendants (MDX) | Gibt die Menge der vorausgehenden Elemente zu einem angegebenen Element zurück, einschließlich des Elements selbst. |
| Axis (MDX) | Gibt eine in einer Achse definierte Menge zurück. |
| BottomCount (MDX) | Sortiert eine Menge in aufsteigender Reihenfolge und gibt die angegebene Anzahl von Tupeln mit den niedrigsten Werten zurück. |
| BottomPercent (MDX) | Sortiert eine Menge in aufsteigender Reihenfolge und gibt eine Menge von Tupeln mit den niedrigsten Werten zurück, deren kumulativer Gesamtwert kleiner oder gleich einem angegebenen Prozentsatz ist. |
| BottomSum (MDX) | Sortiert eine Menge in aufsteigender Reihenfolge und gibt eine Menge von Tupeln mit den niedrigsten Werten zurück, deren Gesamtwert kleiner oder gleich einem angegebenen Wert ist. |
| Children (MDX) | Gibt die untergeordneten Elemente eines angegebenen Elements zurück. |
| Crossjoin (MDX) | Gibt das Kreuzprodukt mindestens einer Menge zurück. |
| CurrentOrdinal (MDX) | Gibt die aktuelle Iterationsnummer in einer Menge während einer Iteration zurück. |
| Descendants (MDX) | Gibt eine Menge von nachfolgenden Werten eines Elements auf einer angegebenen Ebene oder in einem angegebenen Abstand zurück. Optional können nachfolgende Werte anderer Ebenen ein- oder ausgeschlossen werden. |
| Distinct (MDX) | Gibt eine Menge zurück, wobei doppelte Tupel aus einer angegebenen Menge entfernt werden. |
| DrilldownLevel (MDX) | Führt einen Drilldown der Elemente einer Menge in eine Ebene unter der untersten Ebene aus, die in der Menge dargestellt ist, oder in eine Ebene unter einer optional angegebenen Ebene eines Elements, das in der Menge dargestellt wird. |
| DrilldownLevelBottom (MDX) | Führt einen Drilldown der untersten Elemente einer Menge auf einer angegebenen Ebene in eine darunter liegende Ebene aus. |
| DrilldownLevelTop (MDX) | Führt einen Drilldown der obersten Elemente einer Menge auf einer bestimmten Ebene in eine darunter liegende Ebene aus. |
| DrilldownMember (MDX) | Führt einen Drilldown für Elemente in einer angegebenen Menge aus, die in einer angegebenen zweiten Menge vorhanden sind. Alternativ führt die Funktion einen Drilldown für eine Menge von Tupeln aus. |
| DrilldownMemberBottom (MDX) | Führt einen Drilldown bei Elementen in einer angegebenen Menge aus, die in einer angegebenen zweiten Menge vorhanden sind, wobei das Resultset auf eine angegebene Anzahl von Elementen beschränkt wird. Alternativ führt die Funktion auch einen Drilldown für eine Menge von Tupeln aus. |
| DrilldownMemberTop (MDX) | Führt einen Drilldown bei Elementen in einer angegebenen Menge aus, die in einer angegebenen zweiten Menge vorhanden sind, wobei das Resultset auf eine angegebene Anzahl von Elementen beschränkt wird. Alternativ dazu wird mit dieser Funktion ein Drilldown für eine Reihe von Tupeln durchgeführt. |
| DrillupLevel (MDX) | Führt einen Drillup bei Elementen einer Menge aus, die sich unterhalb einer angegebenen Ebene befinden. |
| DrillupMember (MDX) | Führt einen Drillup für die Elemente einer angegebenen Menge aus, die in einer zweiten angegebenen Menge vorhanden sind. |
| Except (MDX) | Gibt die Differenzmenge zweier Mengen zurück. Optional werden doppelte Werte beibehalten. |
| Exists (MDX) | Gibt die Menge der Elemente einer Menge zurück, die mit mindestens einem Tupel mindestens einer anderen Menge vorhanden sind. |
| Extract (MDX) | Gibt eine Menge von Tupeln aus extrahierten Dimensionselementen zurück. |
| Filter (MDX) | Filtert eine angegebene Menge basierend auf einer Suchbedingung und gibt dann das Resultset zurück. |
| Generate (MDX) | Wendet eine Menge auf jedes Element einer anderen Menge an und verknüpft dann die entstehenden Mengen durch den Vereinigungsoperator. Alternativ gibt die Funktion eine verkettete Zeichenfolge zurück, die durch Auswerten eines Zeichenfolgenausdrucks über einer Menge erstellt wurde. |
| Head (MDX) | Gibt die erste angegebene Anzahl von Elementen aus einer Menge zurück, wobei doppelte Werte beibehalten werden. |
| Hierarchize (MDX) | Ordnet die Elemente einer Menge hierarchisch an. |
| Intersect (MDX) | Gibt die Schnittmenge zweier Eingabesets zurück. Optional werden doppelte Werte beibehalten. |
| LastPeriods (MDX) | Gibt eine Menge von Elementen bis zu einem angegebenen Element, einschließlich des Elements, zurück. |
| Members (Menge) (MDX) | Gibt die Menge der Elemente in einer Dimension, Ebene oder Hierarchie zurück. |
| Mtd (MDX) | Gibt eine Menge von gleichgeordneten Elementen zurück, die derselben Ebene angehören wie ein angegebenes Element. Die Menge beginnt mit dem ersten gleichgeordneten Element und endet mit dem angegebenen Element, entsprechend der Einschränkung durch die Year-Ebene in der Time-Dimension. |
| NameToSet (MDX) | Gibt einen Satz zurück, der den durch eine MDX-formatierte Zeichenfolge angegebenen Member enthält. |
| NonEmptyCrossjoin (MDX) | Gibt das Kreuzprodukt mindestens einer Menge als eine Menge zurück, wobei leere Tupel und Tupel ohne zugeordnete Daten einer Faktentabelle ausgeschlossen werden. |
| Order (MDX) | Ordnet die Elemente einer angegebenen Menge an, wobei die Hierarchie optional beibehalten wird oder nicht. |
| PeriodsToDate (MDX) | Gibt eine Menge von gleichgeordneten Elementen zurück, die derselben Ebene angehören wie ein angegebenes Element. Die Menge beginnt mit dem ersten gleichgeordneten Element und endet mit dem angegebenen Element, entsprechend der Einschränkung durch die angegebene Ebene in der Time-Dimension. |
| Qtd (MDX) | Gibt einen Satz von gleichgeordneten Membern aus der gleichen Ebene wie ein bestimmtes Element zurück, beginnend mit dem ersten gleichgeordneten Element und endend mit dem angegebenen Member, wie durch die Quarter-Ebene in der Zeitdimension eingeschränkt. |
| Siblings (MDX) | Gibt die gleichgeordneten Elemente eines angegebenen Elements zurück, einschließlich des Elements selbst. |
| StripCalculatedMembers (MDX) | Gibt eine Menge zurück, die durch Entfernen berechneter Elemente aus einer angegebenen Menge entsteht. |
| StrToSet (MDX) | Gibt den Satz zurück, der durch eine MDX-formatierte Zeichenfolge angegeben wird. |
| Subset (MDX) | Gibt eine Teilmenge von Tupeln aus einer angegebenen Menge zurück. |
| Tail (MDX) | Gibt eine Teilmenge vom Ende einer Menge zurück. |
| ToggleDrillState (MDX) | Schaltet den Drillstatus von Elementen um. |
| TopCount (MDX) | Sortiert eine Menge in absteigender Reihenfolge und gibt die angegebene Anzahl von Elementen mit den höchsten Werten zurück. |
| TopPercent (MDX) | Sortiert eine Menge in absteigender Reihenfolge und gibt eine Menge von Tupeln mit den höchsten Werten zurück, deren kumulativer Gesamtwert kleiner oder gleich einem angegebenen Prozentsatz ist. |
| TopSum (MDX) | Sortiert eine Menge und gibt die obersten Elemente zurück, deren kumulative Summe mindestens einem angegebenen Wert entspricht. |
| Union (MDX) | Gibt die Vereinigungsmenge zweier Mengen zurück. Optional werden doppelte Werte beibehalten. |
| Unorder (MDX) | Entfernt eine erzwungene Reihenfolge von einer angegebenen Menge. |
| VisualTotals (MDX) | Gibt eine Menge zurück, die durch dynamische Gesamtwertbildung der untergeordneten Elemente in einer angegebenen Menge generiert wird. Optional wird im resultierenden Cellset ein Muster für den Namen des übergeordneten Elements verwendet. |
| Wtd (MDX) | Gibt eine Menge von gleichgeordneten Elementen zurück, die derselben Ebene angehören wie ein angegebenes Element. Die Menge beginnt mit dem ersten gleichgeordneten Element und endet mit dem angegebenen Element, entsprechend der Einschränkung durch die Week-Ebene in der Time-Dimension. |
| Ytd (MDX) | Gibt einen Satz gleichgeordneter Member aus der gleichen Ebene wie ein bestimmtes Element zurück, beginnend mit dem ersten gleichgeordneten Element und endend mit dem angegebenen Member, wie durch die Year-Ebene in der Zeitdimension eingeschränkt. |
Zeichenfolgenfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| CalculationPassValue (MDX) | Gibt den Wert eines MDX-Ausdrucks zurück, der über einem angegebenen Berechnungsdurchlauf eines Cubes ausgewertet wird. |
| CoalesceEmpty (MDX) | Koaliert einen leeren Zellwert mit einer Zahl oder einer Zeichenfolge und gibt den koalierten Wert zurück. |
| Generate (MDX) | Wendet eine Menge auf jedes Element einer anderen Menge an und verknüpft dann die entstehenden Mengen durch den Vereinigungsoperator. Alternativ gibt die Funktion eine verkettete Zeichenfolge zurück, die durch Auswerten eines Zeichenfolgenausdrucks über einer Menge erstellt wurde. |
| IIf (MDX) | Gibt in Abhängigkeit von einem logischen Test einen von zwei Werten zurück. |
| LookupCube (MDX) | Gibt den Wert eines MDX-Ausdrucks zurück, der über einem anderen angegebenen Cube in derselben Datenbank ausgewertet wird. |
| MemberToStr (MDX) | Gibt eine MDX-formatierte Zeichenfolge zurück, die einem angegebenen Member entspricht. |
| Name (MDX) | Gibt den Namen einer Dimension, einer Hierarchie, einer Ebene oder eines Elements zurück. |
| Properties (MDX) | Gibt eine Zeichenfolge oder einen stark typisierten Wert zurück, der den Wert einer Elementeigenschaft enthält. |
| SetToStr (MDX) | Gibt eine Zeichenfolge im MDX-Format zurück, die einer angegebenen Menge entspricht. |
| TupleToStr (MDX) | Gibt eine MDX-formatierte Zeichenfolge zurück, die dem angegebenen Tupel entspricht. |
| UniqueName (MDX) | Gibt den eindeutigen Namen einer angegebenen Dimension, Hierarchie, Ebene oder eines angegebenen Elements zurück. |
| UserName (MDX) | Gibt den Domänennamen und den Benutzernamen der aktuellen Verbindung zurück. |
Teilcubefunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| This (MDX) | Gibt den aktuellen Teilcube zurück. |
| Leaves (MDX) | Gibt die Menge der Blattelemente in der angegebenen Dimension, im angegebenen Element oder Tupel zurück. |
Tupelfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| Current (MDX) | Gibt das aktuelle Tupel in einer Menge während einer Iteration zurück. |
| Item (Tupel) (MDX) | Gibt ein Tupel aus einer Menge zurück. |
| Root (MDX) | Gibt ein Tupel zurück, das aus den Elementen Alle aus jeder Attributhierarchie in einem Cube, einer Dimension oder einem Tupel besteht. |
| StrToTuple (MDX) | Gibt das Durch eine MDX-formatierte Zeichenfolge angegebene Tupel zurück. |
Weitere Funktionen
| Funktion | BESCHREIBUNG |
|---|---|
| Error (MDX) | Löst einen Fehler aus. Optional wird eine angegebene Fehlermeldung ausgegeben. |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für