pandas.merge

pandas.merge(left, right, how='inner', on=None, left_on=None, right_on=None, left_index=False, right_index=False, sort=False, suffixes=('_x', '_y'), copy=True, indicator=False) [source]

Объединение объектов DataFrame путём выполнения операции присоединения в стиле баз данных по столбцам или индексам.

Если присоединение выполняется по столбцам, индексы DataFrame будут проигнорированы. В противном случае, если присоединение выполняется по индексам или по индексу и столбцу/столбцам, индекс будет передан.

Параметры:

left : DataFrame right : DataFrame how : {‘left’, ‘right’, ‘outer’, ‘inner’}, по умолчанию ‘inner’ left: использовать только ключи из левой таблицы (SQL: левое внешнее соединение) right: использовать только ключи из правой таблицы (SQL: правое внешнее соединение) outer: использовать объединение ключей из обеих таблиц (SQL: полное внешнее соединение) inner: использовать пересечение ключей из обеих таблиц (SQL: внутреннее соединение) on : метка или список Имена столбцов для присоединения. Должны быть найдены в обоих DataFrame. Если on равно None и присоединение не выполняется по индексам, то по умолчанию выполняется присоединение по пересечению столбцов. left_on : метка или список, или массив-подобный объект Имена столбцов для присоединения в левом DataFrame. Может быть вектором или списком векторов длиной DataFrame для использования конкретного вектора в качестве ключа присоединения вместо столбцов right_on : метка или список, или массив-подобный объект Имена столбцов для присоединения в правом DataFrame или вектор/список векторов по документации left_on left_index : булево значение, по умолчанию False Использовать индекс из левого DataFrame в качестве ключа(ей) присоединения. Если это Многоуровневый индекс, количество ключей в другом DataFrame (либо индекс, либо количество столбцов) должно совпадать с количеством уровней right_index : булево значение, по умолчанию False Использовать индекс из правого DataFrame в качестве ключа присоединения. Аналогичные ограничения, как и для left_index sort : булево значение, по умолчанию False Сортировать ключи присоединения лексикографически в результирующем DataFrame suffixes : последовательность длины 2 (кортеж, список, ...) Суффикс, который применяется к совпадающим именам столбцов в левой и правой частях соответственно copy : булево значение, по умолчанию True Если False, не копировать данные ненужно indicator : булево значение или строка, по умолчанию False Если True, добавляет столбец в выходной DataFrame под названием «_merge» с информацией о источнике каждой строки. Если строка, столбец с информацией об источнике каждой строки будет добавлен в выходной DataFrame, и столбец будет назван значением строки. Столбец информации имеет тип Categorical и принимает значение «left_only» для наблюдений, ключ присоединения которых появляется только в левом DataFrame, «right_only» для наблюдений, ключ присоединения которых появляется только в правом DataFrame, и «both», если ключ присоединения наблюдения найден в обоих DataFrame. Новая в версии 0.17.0.

Возвращает:

merged : DataFrame Тип выходных данных будет таким же, как у ‘left’, если это подкласс DataFrame.

См. также

merge_ordered, merge_asof

Примеры

>>> A              >>> B
    lkey value         rkey value
0   foo  1         0   foo  5
1   bar  2         1   bar  6
2   baz  3         2   qux  7
3   foo  4         3   bar  8

>>> A.merge(B, left_on='lkey', right_on='rkey', how='outer')
   lkey  value_x  rkey  value_y
0  foo   1        foo   5
1  foo   4        foo   5
2  bar   2        bar   6
3  bar   2        bar   8
4  baz   3        NaN   NaN
5  NaN   NaN      qux   7