Funzioni di Generatore report - funzione di aggregazioneReport Builder Functions - Aggregate Function

Restituisce un'aggregazione personalizzata dell'espressione specificata, secondo quanto definito dal provider di dati.Returns a custom aggregate of the specified expression, as defined by the data provider.

Nota

È possibile creare e modificare file di definizioni report impaginati (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati.Each authoring environment provides different ways to create, open, and save reports and related items.

SintassiSyntax


Aggregate(expression, scope)  

ParametriParameters

espressioneexpression
Espressione su cui eseguire l'aggregazione.The expression on which to perform the aggregation. È necessario che l'espressione sia un riferimento di campo semplice.The expression must be a simple field reference.

ambitoscope
(Stringa) Nome di un set di dati, gruppo o area dati che contiene gli elementi del report a cui applicare la funzione di aggregazione.(String) The name of a dataset, group, or data region that contains the report items to which to apply the aggregate function. Ambito deve essere una costante di tipo stringa e non può essere un'espressione.Scope must be a string constant andcannot be an expression. Se si omette scope , viene usato l'ambito corrente.If scope is not specified, the current scope is used.

Tipo restituitoReturn Type

Il tipo restituito dipende dal provider di dati.Return type is determined by the data provider. Restituisce Nothing se il provider di dati non supporta questa funzione o se i dati non sono disponibili.Returns Nothing if the data provider does not support this function or data is not available.

OsservazioniRemarks

La funzione Aggregate offre una modalità per usare aggregazioni calcolate sull'origine dati esterna.The Aggregate function provides a way to use aggregates that are calculated on the external data source. Il supporto per questa caratteristica è determinato dall'estensione dei dati.Support for this feature is determined by the data extension. L'estensione dell'elaborazione dati SQL ServerSQL Server Analysis ServicesAnalysis Services , ad esempio, consente di recuperare set di righe bidimensionali da una query MDX.For example, the SQL ServerSQL Server Analysis ServicesAnalysis Services data processing extension retrieves flattened rowsets from an MDX query. Alcune righe del set di risultati possono contenere valori di aggregazione calcolati nel server dell'origine dati.Some rows in the result set can contain aggregate values calculated on the data source server. Tali valori sono noti come aggregazioni server.These are known as server aggregates. Per visualizzare le aggregazioni server nella finestra Progettazione query con interfaccia grafica per Analysis ServicesAnalysis Services, è possibile usare il pulsante Mostra aggregazione sulla barra degli strumenti.To view server aggregates in the graphical query designer for Analysis ServicesAnalysis Services, you can use the Show Aggregate button on the toolbar. Per altre informazioni, vedere Interfaccia utente di Progettazione query MDX di Analysis Services (Generatore report ).For more information, see Analysis Services MDX Query Designer User Interface (Report Builder).

Quando si visualizza la combinazione di valori di aggregazione e di set di dati di dettaglio nelle righe di dettaglio di un'area dati Tablix, le aggregazioni server non vengono solitamente incluse perché non corrispondono a dati di dettaglio.When you display the combination of aggregate and detail dataset values on detail rows of a Tablix data region, server aggregates would not typically be included because they are not detail data. Tuttavia, è possibile visualizzare tutti i valori recuperati per il set di dati e personalizzare le modalità di calcolo e visualizzazione dei dati di aggregazione.However, you may want to display all values retrieved for the dataset and customize the way aggregate data is calculated and displayed.

Reporting ServicesReporting Services rileva l'uso della funzione Aggregate nelle espressioni del report per determinare se visualizzare aggregazioni server nelle righe di dettaglio. detects the use of the Aggregate function in expressions in your report in order to determine whether to display server aggregates on detail rows. Se si include Aggregate in un'espressione in un'area dati, le aggregazioni server possono essere visualizzate solo in righe di totali o totali complessivi di gruppo, non nelle righe di dettaglio.If you include Aggregate in an expression in a data region, server aggregates can only appear on group total or grand total rows, not on detail rows. Se si desidera visualizzare le aggregazioni server nelle righe di dettaglio, non usare la funzione Aggregate .If you want to display server aggregates on detail rows, do not use the Aggregate function.

È possibile cambiare questo comportamento predefinito modificando il valore dell'opzione Interpretare i subtotali come righe di dettaglio nella finestra di dialogo Proprietà set di dati .You can change this default behavior by changing the value of the Interpret subtotals as details option on the Dataset Properties dialog box. Quando questa opzione è impostata su True, tutti i dati, incluse le aggregazioni server, appaiono come dati di dettaglio.When this option is set to True, all data, including server aggregates, appears as detail data. Quando è impostata su False, le aggregazioni server appaiono come totali.When set to False, server aggregates appear as totals. L'impostazione di questa proprietà influisce su tutte le aree dati collegate al set di dati.The setting for this property affects all data regions that are linked to this dataset.

Nota

Tutti i gruppi di contenuto per l'elemento del report che fa riferimento ad Aggregate devono includere riferimenti di campo semplici per le relative espressioni di raggruppamento, ad esempio [FieldName].All containing groups for the report item that references Aggregate must have simple field references for their group expressions, for example, [FieldName]. Non è possibile usare Aggregate in un'area dati che usa espressioni di raggruppamento complesse.You cannot use Aggregate in a data region that uses complex group expressions. Per l'estensione di elaborazione dati SQL ServerSQL Server Analysis ServicesAnalysis Services la query deve includere campi MDX di tipo LevelProperty (non MemberProperty) per supportare l'aggregazione con la funzione Aggregate.For the SQL ServerSQL Server Analysis ServicesAnalysis Services data processing extension, your query must include MDX fields of type LevelProperty (not MemberProperty) to support aggregation using the Aggregatefunction.

Expression può contenere chiamate alle funzioni di aggregazione nidificate con le eccezioni e le condizioni seguenti:Expression can contain calls to nested aggregate functions with the following exceptions and conditions:

Confronto tra le funzioni Aggregate e SumComparing the Aggregate and Sum Functions

La funzione Aggregate è diversa dalle funzioni di aggregazioni numeriche come Sum in quanto la funzione Aggregate restituisce un valore calcolato dal provider di dati o dall'estensione per l'elaborazione dati.The Aggregate function differs from numeric aggregate functions like Sum in that the Aggregate function returns a value that is calculated by the data provider or data processing extension. Le funzioni di aggregazione numeriche come Sum restituiscono invece un valore calcolato dal componente Elaborazione report in un set di dati determinato dal parametro scope .Numeric aggregate functions like Sum return a value that is calculated by the report processor on a set of data from the dataset that is determined by the scope parameter. Per altre informazioni, vedere le funzioni di aggregazione elencate in Riferimento a funzioni di aggregazione (Generatore report e SSRS).For more information, see the aggregate functions listed in Aggregate Functions Reference (Report Builder and SSRS).

EsempioExample

Nell'esempio di codice seguente è illustrata un'espressione che recupera un'aggregazione server per il campo LineTotal.The following code example shows an expression that retrieves a server aggregate for the field LineTotal. L'espressione viene aggiunta nella riga di una cella che appartiene al gruppo GroupbyOrder.The expression is added to a cell in a row that belongs to the group GroupbyOrder.

=Aggregate(Fields!LineTotal.Value, "GroupbyOrder")  

Vedere ancheSee Also

Utilizzo delle espressioni nei report ( Generatore report e SSRS ) Expression Uses in Reports (Report Builder and SSRS)
Esempi di espressioni ( Generatore report e SSRS ) Expression Examples (Report Builder and SSRS)
Tipi di dati in espressioni ( Generatore report e SSRS ) Data Types in Expressions (Report Builder and SSRS)
Ambito di espressioni per totali, aggregazioni e raccolte predefinite ( Generatore report e SSRS )Expression Scope for Totals, Aggregates, and Built-in Collections (Report Builder and SSRS)