Freigeben über

Referenz zu Aggregatfunktionen (Berichts-Generator und SSRS)

Um aggregierte Werte in Ihren Bericht einzuschließen, können Sie integrierte Aggregatfunktionen in Ausdrücken verwenden. Die Standardaggregatfunktion für numerische Felder ist SUM. Sie können den Ausdruck bearbeiten und eine andere integrierte Aggregatfunktion verwenden oder einen anderen Bereich angeben. Mit dem Bereich wird angegeben, welcher Satz an Daten für die Berechnung verwendet werden soll.

Der Berichtsprozessor kombiniert Berichtsdaten und das Berichtslayout, und die Ausdrücke für jedes Berichtselement werden ausgewertet. Beim Anzeigen der einzelnen Seiten des Berichts sehen Sie die Ergebnisse für jeden Ausdruck in den gerenderten Berichtselementen.

In der folgenden Tabelle sind Kategorien von integrierten Funktionen aufgeführt, die Sie in einen Ausdruck einschließen können:

Zur Bestimmung der gültigen Bereiche für eine Funktion lesen Sie im entsprechenden Funktionsreferenzthema nach. Weitere Informationen und Beispiele finden Sie unter Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Sammlungen (Berichts-Generator und SSRS).

Hinweis

Sie können Berichtsdefinitionen (RDL) im Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Möglichkeiten zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten im Berichts-Designer und Berichts-Generator (SSRS) im Web unter microsoft.com.

Integrierte Aggregatfunktionen

Die folgenden integrierten Funktionen berechnen Summenwerte für einen Satz von numerischen Daten ungleich null im Standardbereich oder im benannten Bereich.

Funktion Beschreibung
Avg Gibt den Durchschnitt aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des festgelegten Bereichs ausgewertet zurück.
Zählen Gibt die Anzahl der Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des festgelegten Bereichs ausgewertet zurück.
CountDistinct Gibt die Anzahl aller unterschiedlichen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des angegebenen Bereichs ausgewertet zurück.
Max. Gibt den Maximalwert aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des angegebenen Bereichs zurück. Sie können diese Funktion verwenden, um einen Diagrammachsen-Höchstwert zur Steuerung der Skala anzugeben.
Min Gibt den Minimalwert aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des angegebenen Bereichs zurück. Sie können diese Funktion verwenden, um einen Diagrammachsen-Mindestwert zur Steuerung der Skala anzugeben.
StDev Gibt die Standardabweichung aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des angegebenen Bereichs ausgewertet zurück.
StDevP Gibt die Standardabweichung der Auffüllung aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des festgelegten Bereichs ausgewertet zurück.
Summe Gibt die Summe aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des festgelegten Bereichs ausgewertet zurück.
Vereinigung Gibt die Vereinigung aller nicht null-räumlichen Datenwerte vom Typ SqlGeometry zurück oder SqlGeography die vom Ausdruck angegeben werden, ausgewertet im angegebenen Bereich.
Var Gibt die Varianz aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des festgelegten Bereichs ausgewertet zurück.
VarP Gibt die Auffüllungsvarianz aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck im Kontext des angegebenen Bereichs ausgewertet zurück.

Einschränkungen bei integrierten Feldern, Auflistungen und Aggregatfunktionen

In der folgenden Tabelle werden Einschränkungen für Berichtspositionen zusammengefasst, auf deren Grundlage Sie Ausdrücke hinzufügen können, die Verweise auf globale integrierte Auflistungen enthalten.

Position im Bericht Felder Die Parameter Berichtselemente Seitenzahl

Gesamtseitenzahl		 Datenquelle

Datensatz		 Variablen RenderFormat
Seitenheader

Seitenfuß		 Ja Ja Höchstens eins

Hinweis 1		 Ja Ja Ja Ja
Körper Ja

Hinweis 2		 Ja Nur Elemente im Currnet-Bereich oder einem enthaltenden Bereich

Hinweis 3		 Nein Ja Ja Ja
Berichtsparameter Nein Nur Parameter am Anfang der Liste

Hinweis 4		 Nein Nein Nein Nein Nein
Feld Ja Ja Nein Nein Nein Nein Nein
Abfrageparameter Nein Ja Nein Nein Nein Nein Nein
Gruppierungsausdruck Ja Ja Nein Nein Ja Nein Nein
Sortierungsausdruck Ja Ja Nein Nein Ja Ja

Hinweis 5		 Nein
Filterausdruck Ja Ja Nein Nein Ja Ja

Hinweis 6		 Nein
Programmcode Nein Ja

Hinweis 7		 Nein Nein Nein Nein Nein
Berichtssprache Nein Ja Nein Nein Nein Nein Nein
Variablen Ja Ja Nein Nein Ja Aktueller oder enthaltener Bereich Nein
Aggregate Ja Ja Nur in Seitenkopf/Seitenfuß Nur in Berichtselementaggregaten Ja Nein Nein
Suchfunktionen Ja Ja Ja Nein Ja Nein Nein

  • Hinweis 1. Berichtselemente müssen in der gerenderten Berichtsseite vorhanden sein, oder der Wert ist NULL. Wenn die Sichtbarkeit eines Berichtselements von einem Ausdruck abhängt, der False ergibt, ist das Berichtselement auf der Seite nicht vorhanden.

  • Hinweis 2. Wenn ein Feldverweis in einem Gruppenbereich verwendet wird und der Feldverweis nicht im Gruppenausdruck enthalten ist, dann wird die Definition des Werts für das Feld aufgehoben, außer wenn es nur einen Wert im Bereich gibt. Verwenden Sie Erste oder Letzte und den Gruppenbereich, um einen Wert anzugeben.

  • Hinweis 3. Ausdrücke, die einen Verweis auf Berichtselemente einschließen, können Werte für andere Berichtselemente im gleichen Gruppenbereich oder einem enthaltenen Gruppenbereich angeben.

  • Hinweis 4. Die Eigenschaftswerte für frühere Parameter sind u. U. NULL.

  • Hinweis 5. Nur in Mitgliedssortierungen. Nicht zu verwenden in Ausdrücken für die Datenbereichssortierung.

  • Hinweis 6. Nur in Mitgliedsfiltern. Nicht zu verwenden in Datenbereichs- oder Datasetfilterausdrücken.

  • Hinweis 7. Die Parametersammlung wird erst initialisiert, nachdem der Codeblock verarbeitet wurde, daher können keine Methoden zum Steuern von Parametern während der Initialisierung verwendet werden.

  • Hinweis 8. Der Datentyp für alle Aggregate außer Count und CountDistinct muss für alle Werte der gleiche Datentyp oder NULL sein.

Beschränkungen bei geschachtelten Aggregaten

In der folgenden Tabelle finden Sie Einschränkungen, auf deren Grundlage Aggregatfunktionen andere Aggregatfunktionen als geschachtelte Aggregate angeben können.

Kontext RunningValue RowNumber Erste

Letzte		 Vorhergehend Sum und andere Vorsortierungsfunktionen ReportItem-Aggregate Suchfunktionen Aggregatfunktion
Ausgeführter Wert Nein Nein Nein Nein Ja Nein Ja Nein
Erste

Letzte		 Nein Nein Nein Nein Ja Nein Nein Nein
Vorhergehend Ja Ja Ja Nein Ja Nein Ja Nein
Sum und andere Vorsortierungsfunktionen Nein Nein Nein Nein Ja Nein Ja Nein
ReportItem-Aggregate Nein Nein Nein Nein Nein Nein Nein Nein
Suchfunktionen Ja Ja

Hinweis 1		 Ja

Hinweis 1		 Ja

Hinweis 1		 Ja

Hinweis 1		 Ja

Hinweis 1		 Nein Nein
Aggregatfunktion Nein Nein Nein Nein Nein Nein Nein Nein
  • Hinweis 1. Aggregatfunktionen sind nur im Source -Ausdruck einer Suchfunktion zulässig, wenn die Suchfunktion nicht in einem Aggregat enthalten ist. Aggregatfunktionen sind im Destination -Ausdruck oder Result -Ausdruck einer Suchfunktion nicht zulässig.

Berechnen von ausgeführten Werten

Die folgenden integrierten Funktionen berechnen ausgeführte Werte für einen Satz von Daten. RowNumber ist ähnlich wie RunningValue, da es den aktuellen Wert eines Zählers zurückgibt, der für jede Zeile innerhalb des enthaltenden Bereichs erhöht wird. Der Bereichsparameter für diese Funktionen muss einen enthaltenden Bereich angeben, der steuert, wann der Zähler neu gestartet wird.

Funktion Beschreibung
RowNumber Gibt eine laufende Zählung der Zeilenanzahl für den angegebenen Bereich zurück. Die RowNumber Funktion startet die Zählung bei 1 neu, nicht bei 0.
RunningValue Gibt ein laufendes Aggregat aller numerischen Werte ungleich NULL aus dem angegebenen Ausdruck für den Kontext des angegebenen Bereichs ausgewertet zurück.

Abrufen von Zeilenanzahlen

Die folgende integrierte Funktion berechnet die Anzahl von Zeilen im angegebenen Bereich. Verwenden Sie diese Funktion, um alle Zeilen zu zählen, einschließlich Zeilen mit NULL-Werten.

Funktion Beschreibung
CountRows Gibt die Anzahl der Zeilen im angegebenen Bereich zurück, einschließlich der Zeilen mit NULL-Werten.

Nachschlagen von Werten aus einem anderen Dataset

Die folgenden Suchfunktionen rufen Werte aus einem angegebenen Dataset ab.

Funktion Beschreibung
Lookup-Funktion Gibt für einen angegebenen Ausdruck einen Wert aus einem Dataset zurück.
LookupSet-Funktion Gibt für einen angegebenen Ausdruck einen Satz von Werten aus einem Dataset zurück.
Multilookup-Funktion Gibt den Satz der ersten übereinstimmenden Werte für einen Satz von Namen aus einem Dataset mit Name-Wert-Paaren zurück.

Abrufen von sortierungsabhängigen Werten

Die folgenden integrierten Funktionen geben den ersten, letzten oder vorherigen Wert innerhalb eines gegebenen Bereichs zurück. Diese Funktionen hängen von der Sortierreihenfolge der Datenwerte ab. Verwenden Sie diese Funktionen, um beispielsweise den ersten und den letzten Wert auf einer Seite zu suchen, um Seitenkopfzeilen im Wörterbuchformat zu erstellen. Verwenden Sie Previous, um einen Wert in einer Zeile mit dem Wert der vorherigen Zeile innerhalb eines bestimmten Bereichs zu vergleichen, beispielsweise um Jahr-über-Jahr-Werte in einer Tabelle zu suchen.

Funktion Beschreibung
Erste Gibt den ersten Wert im festgelegten Bereich des angegebenen Ausdrucks zurück.
Letzte Gibt den letzten Wert im festgelegten Bereich des angegebenen Ausdrucks zurück.
Vorhergehend Gibt den Wert oder den angegebenen Aggregatwert für die vorherige Instanz eines Elements innerhalb des angegebenen Bereichs zurück.

Abrufen von Serveraggregaten

Die folgende integrierte Funktion ruft benutzerdefinierte Aggregate vom Datenanbieter ab. Mithilfe eines Analysis Services-Datenquellentyps können Sie beispielsweise Aggregate, die auf dem Datenquellenserver berechnet wurden, für die Verwendung in einer Gruppenkopfzeile abrufen.

Funktion Beschreibung
Aggregat Gibt ein benutzerdefiniertes Aggregat des angegebenen Ausdrucks gemäß der Definition durch den Datenanbieter zurück.

Testen für Bereich

Die folgende integrierte Funktion testet den aktuellen Kontext eines Berichtselements, um festzustellen, ob dieses Mitglied eines bestimmten Bereichs ist.

Funktion BESCHREIBUNG
InScope Gibt an, ob sich die aktuelle Instanz eines Elements innerhalb des angegebenen Bereichs befindet.

Abrufen von rekursiven Ebenen

Die folgende integrierte Funktion ruft die aktuelle Ebene ab, wenn eine rekursive Hierarchie verarbeitet wird. Verwenden Sie das Ergebnis dieser Funktion mit der Padding Eigenschaft in einem Textfeld, um die Einzugsebene einer visuellen Hierarchie für eine rekursive Gruppe zu steuern. Weitere Informationen finden Sie unter Erstellen von rekursiven Hierarchiegruppen (Berichts-Generator und SSRS).

Funktion BESCHREIBUNG
Grad Gibt die aktuelle Ebene in einer rekursiven Hierarchie zurück.

Siehe auch

Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)
Beispiele für Ausdrücke (Berichts-Generator und SSRS)
Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS)

  • Last updated on