Функции построителя отчетов — функция Aggregate в отчете с разбивкой на страницы (построитель отчетов)

Область применения: Построитель отчетов (SSRS) Power BI конструктор отчетов построитель отчетов в SQL Server Data Tools

Возвращает пользовательские статистические данные заданного выражения в отчете с разбивкой на страницы в соответствии с определением поставщика данных.

Примечание.

Создать и изменить определение для отчета на страницу (RDL-файл) можно с помощью построителя отчетов (Майкрософт), построителя отчетов Power BI и конструктора отчетов в SQL Server Data Tools.

Синтаксис

  
Aggregate(expression, scope)  

Параметры

выражение
Выражение, к которому применяется статистическая обработка. Это выражение должно быть простой ссылкой на поле.

область
(String) Имя набора данных, группы или области данных, содержащих элементы отчета, к которым применяется агрегатная функция. Scope должна быть строковой константой и не может являться выражением. Если аргумент scope не задан, используется текущая область.

Тип возвращаемых данных

Тип возвращаемых данных определяется поставщиком данных. Возвращает Nothing , если поставщик данных не поддерживает эту функцию или данные недоступны.

Замечания

Функция Aggregate предоставляет способ использования статистических значений, вычисленных на внешнем источнике данных. Поддержка этой функции определяется модулем обработки данных. Например, модуль обработки данных служб SQL Server Analysis Services получает плоские наборы строк из запроса многомерных выражений. Некоторые строки результирующего набора могут содержать статистические значения, вычисленные на сервере источника данных. Они известны как серверные статистические значения. Чтобы просмотреть серверные статистические выражения в графическом конструкторе запросов служб Analysis Services, можно использовать кнопку Show Aggregate (Показать статистическое выражение) на панели инструментов. Дополнительные сведения см. в статье Пользовательский интерфейс конструктора запросов многомерных выражений служб Analysis Services.

При отображении сочетания значений статистического выражения и набора данных строк с подробными сведениями области данных табликса серверные статистические выражения обычно не отображаются, так как они не имеют подробных данных. Однако может потребоваться отображение всех значений, полученных для набора данных, и настройка способа вычисления и отображения статистических данных.

Построитель отчетов определяет использование функции Aggregate в выражениях отчета, чтобы определить, отображать ли серверные статистические выражения в строках с подробными сведениями. При включении функции Aggregate в выражение области данных серверные статистические выражения появляются только в строках группы «Итог» и «Общий итог», но не в строках с подробными сведениями. Если требуется отобразить серверные статистические данные в строках с подробными сведениями, не следует использовать функцию Aggregate .

Можно изменить поведение по умолчанию путем изменения значения параметра Рассматривать подытоги как строки детализации в диалоговом окне Свойства набора данных . При установке этого параметра в значение Trueвсе данные, включая серверные статистические выражения, отображаются как подробные данные. При установке на значение Falseсерверные статистические значения отображаются как итоги. Установка этого свойства затрагивает все области данных, связанные с этим набором данных.

Примечание.

Все вмещающие группы элемента отчета, ссылающегося на функцию Aggregate , должны иметь простые ссылки на поля для своих выражений групп, например [FieldName]. Нельзя использовать функцию Aggregate в области данных, использующую сложные выражения групп. Для модуля обработки данных SQL Server Analysis Services запрос должен включать поля многомерных выражений типа LevelProperty (не MemberProperty) для поддержки агрегирования с помощью функции Агрегата.

Expression может содержать вызовы вложенных агрегатных функций со следующими условиями и исключениями.

  • ПараметрScope для вложенных агрегатов должен совпадать с областью внешнего агрегата или входить в нее. Одна область из всех уникальных областей в выражении должна быть дочерней относительно всех других областей.

  • ПараметрScope для вложенных агрегатов не может быть именем набора данных.

  • Expression не может содержать функции First, Last, Previousи RunningValue .

  • Expression не может содержать вложенные агрегаты, в которых указан параметр recursive.

Дополнительные сведения см. в разделах Справочник по агрегатным функциям (построитель отчетов и SSRS) и Область выражения для суммирования, агрегатных функций и встроенных коллекций (построитель отчетов и SSRS).

Дополнительные сведения о рекурсивных статистических выражениях см. в разделе Создание групп рекурсивной иерархии (построитель отчетов и SSRS).

Сравнение функций Aggregate и Sum

Функция Aggregate отличается от числовых агрегатных функций, например Sum , тем, что функция Aggregate возвращает значение, вычисленное поставщиком данных или модулем обработки данных. Числовые агрегатные функции, например Sum , возвращают значение, вычисляемое обработчиком отчетов из набора данных, определенного параметром scope . Дополнительные сведения см. в списке агрегатных функций в статье Функции построителя отчетов — справочник по агрегатным функциям в отчетах с разбивкой на страницы (построитель отчетов).

Пример

В приведенном ниже примере кода показано выражение, получающее серверное статистическое значение для поля LineTotal. Выражение добавляется в ячейку строки, принадлежащей группе GroupbyOrder.

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