Admin: 1 revision imported

2022-09-07T12:22:32Z

1 revision imported

1>Admin at 12:49, 1 September 2022

2022-09-01T12:49:22Z

Admin: 1 revision imported

2021-02-07T06:53:33Z

1 revision imported

Admin at 07:28, 8 January 2021

2021-01-08T07:28:09Z

New page

{{infobox function
|name=Group
|object=[[Таблица]]
|caption=Группировка
|type=1
|status=2
|db=0
|exception=Неверное имя столбца, невозможно превратить в число, строку
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Таблица]]}}
Функция производит группировку таблицы по указанным столбцам, строки, где совокупность значений столбцов группировки повторяется, будут удалены, при этом над столбцами агрегации для всех строк дублей и строки, оставшейся в таблице, будет произведена указанная операция агрегации. Столбцы, не перечисленные в столбцах группировки и столбцах агрегации, будут удалены. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки при выполнении операций агрегации. После выполнения операции, в таблице сохраняется порядок следования строк, существовавший до операции. Столбцы группировки не должны включать столбцы агрегации и наоборот. Столбцы, не входящие в список столбцов группировки и столбцов агрегации, будут удалены из таблицы. Функция оптимизирована по скорости и создает результирующую таблицу, в которой сохраняется взаимное положение оставшихся в таблице строк. До начала группировки столбцы таблицы, участвующие в ней и содержащие объекты базы данных, должны быть загружены по крайней мере в режиме заголовков, иначе они будут загружаться в процессе проведения группировки (что может быть медленнее).<br />
{{Функции объединения таблиц}}

== Синтаксис ==
<code>
{{Grey|Tab.}}'''Group'''({{Optional|<Наименования столбцов группировки через запятую (STRING)>,<Наименования столбцов для агрегации с типами операций (STRING)>,<Округление при суммировании (INT)>{{Default|{{Eq}}-1}}}})
</code>

==== Аргументы ====
* <code>''<Наименования столбцов группировки через запятую (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов через запятую, по которым будет группироваться таблица. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице.
* <code>''<Наименования столбцов для агрегации с типами операций (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов через запятую, для которых будет выполнена заданная операция агрегации. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице. Формат записи выглядит сл. образом: <code><Столбец1[:<Операция1>][,<Столбец2[:<Операция2>]...]></code>. Функция позволяет использовать следующие операции:
** '''SUM''' (по умолчанию) -- значения столбца для удаляемых строк и оставшихся строк будут найдены суммированием.
** '''AVG''' -- Будут найдены средние значения столбца для удаляемых строк и оставшихся строк.
** '''MAX''' -- В столбцах оставшихся строках будет содержаться максимальное из значение удаляемых строк и оставшихся.
** '''MIN''' -- В столбцах оставшихся строках будет содержаться минимальное из значение удаляемых строк и оставшихся.
** '''COUNT''' -- В столбцах оставшихся строках будет содержаться количество удаленных строк этой группировки, увеличенное на единицу.
** '''FIRST''' -- В столбцах оставшихся строках будет содержаться первое из встреченных значение удаляемых строк и оставшихся.
** '''LAST''' -- В столбцах оставшихся строках будет содержаться последнее из встреченных значение удаляемых строк и оставшихся.
* <code>''<Округление при суммировании (INT)>''</code> - {{Optional}} Задает количество знаков после десятичной точки для округления значения на каждом этапе операции суммирования или нахождения среднего (по умолчанию -1, опция отключена). При нахождении суммы большого числа вещественных чисел (даже если каждое число округлено до определенного количества знаков после точки), может накопиться неточность (см. [[Числа]]). Обычно такие неточности невелики и не имеют никакого значения при расчетах. Однако, для случаев, когда необходима высокая точность при вычислениях чисел с известным количеством знаков после точки, можно использовать эту опцию, которая позволяет автоматически производить округление полученного значения после каждой операции, тем самым исключив накопление неточности. Пример см. ниже.

== Примеры ==
<pre>
//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");

aTab.AddLine("b1,b2,b3,b4",2,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,33);
aTab.AddLine("b1,b2,b3,b4",3,5,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,5,77);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);

//Таблица группируется по значениям столбцов b1 и b2, т.е., в результирующей таблице будут присутствовать только строки с уникальным сочетанием значений столбцов b1 и b2,
// при этом в столбце b4 будет найдена сумма столбца оставленной строки и значений столбцов удаленных строк-дублей,
// а в столбце b3 будет найдено максимальное значение столбца оставленной строки и значений столбцов удаленных строк-дублей.
aTab.Group("b1,b2","b4,b3:MAX");

aTab.Select();
While aTab.Next() Do
Message(""+aTab.b1+"; "+aTab.b2+"; "+aTab.b3+"; "+aTab.b4);
EndDo;

//Будет выведено последовательно:
//"2; 2; 3; 37" -- данная строка была собрана из строк 1 и 2 оригинальной таблицы
//"3; 5; 3; 4" -- данная строка является точной копией строки 3 оригинальной таблицы
//"4; 2; 5; 81" -- данная строка была собрана из строк 4 и 5 оригинальной таблицы, значение 5 взято из строки 5, как максимальное из двух
//"5; 2; 3; 4" -- данная строка является точной копией строки 6 оригинальной таблицы
</pre>

=== Пример, показывающий работу опции по исключению накопления неточности ===
{{Пример суммирования с округлением}}

← Older revision	Revision as of 12:22, 7 September 2022
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Таблица]]}}
-Функция производит группировку таблицы по указанным столбцам, строки, где совокупность значений столбцов группировки повторяется, будут удалены, при этом над столбцами агрегации для всех строк дублей и строки, оставшейся в таблице, будет произведена указанная операция агрегации. Столбцы, не перечисленные в столбцах группировки и столбцах агрегации, будут удалены. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки при выполнении операций агрегации. После выполнения операции, в таблице сохраняется порядок следования строк, существовавший до операции. Столбцы группировки не должны включать столбцы агрегации и наоборот. Столбцы, не входящие в список столбцов группировки и столбцов агрегации, будут удалены из таблицы. Функция оптимизирована по скорости и создает результирующую таблицу, в которой сохраняется взаимное положение оставшихся в таблице строк. До начала группировки столбцы таблицы, участвующие в ней и содержащие объекты базы данных, должны быть загружены по крайней мере в режиме заголовков, иначе они будут загружаться в процессе проведения группировки (что может быть медленнее).<br />
+Функция производит группировку таблицы по указанным столбцам, строки, где совокупность значений столбцов группировки повторяется, будут удалены, при этом над столбцами агрегации для всех строк дублей и строки, оставшейся в таблице, будет произведена указанная операция агрегации. Столбцы, не перечисленные в столбцах группировки и столбцах агрегации, будут удалены. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки при выполнении операций агрегации. После выполнения операции, в таблице сохраняется порядок следования строк, существовавший до операции. Столбцы группировки не должны включать столбцы агрегации и наоборот. Функция оптимизирована по скорости исполнения. До начала группировки столбцы таблицы, участвующие в ней и содержащие объекты базы данных, должны быть загружены по крайней мере в режиме заголовков, иначе они будут загружаться в процессе проведения группировки (что может быть медленнее).<br />
 {{Функции объединения таблиц}}

← Older revision	Revision as of 06:53, 7 February 2021
(No difference)

Tab.Group - Revision history

Admin: 1 revision imported

1>Admin at 12:49, 1 September 2022

Admin: 1 revision imported

Admin at 07:28, 8 January 2021