Admin: 1 revision imported

2021-02-07T06:53:35Z

1 revision imported

Admin at 07:32, 8 January 2021

2021-01-08T07:32:50Z

New page

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

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

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

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

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

bTab.AddLine("b1,b2,b3,b4",5,2,3,4);
bTab.AddLine("b1,b2,b3,b4",3,2,3,4);
bTab.AddLine("b1,b2,b3,b4",4,2,5,4);
bTab.AddLine("b1,b2,b3,b4",4,2,3,4);
bTab.AddLine("b1,b2,b3,b4",5,5,3,4);
bTab.AddLine("b1,b2,b3,b4",1,2,3,4);

aTab.LeftOuterJoin(bTab,"b1,b2","b3:SUM2,b4:SUM");

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

//Будет выведено последовательно:
//"1; 2; 6; 4" -- данная строка является эквивалентной строке 6 второй таблицы, значение b4 берется из нее, так как оно не может добавляться к значению оригинальной таблицы
//"2; 2; 3; 4" -- данная строка не имеет эквивалентных строк
//"3; 5; 5; 4" -- данная строка не имеет эквивалентных строк
//"4; 2; 11; 8" -- данная строка является эквивалентной строкам 3 и 4 второй таблицы, значение b3 является суммой трех значений, b4 -- двух.
//"4; 2; 3; 4" -- данная строка будет пропущена, так как она является дублем предыдущей строки
//"5; 2; 6; 4" -- данная строка является эквивалентной строке 1 второй таблицы, значение b4 берется из нее, так как оно не может добавляться к значению оригинальной таблицы
</pre>

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

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

Tab.LeftOuterJoin - Revision history

Admin: 1 revision imported

Admin at 07:32, 8 January 2021