pandas.DataFrame.merge

DataFrame.merge(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, validate=None) [source]

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

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

Параметры:

right : DataFrame how : {‘left’, ‘right’, ‘outer’, ‘inner’}, по умолчанию ‘inner’ left: использовать только ключи из левой таблицы, аналогично левому внешнему соединению в SQL; сохранять порядок ключей right: использовать только ключи из правой таблицы, аналогично правому внешнему соединению в SQL; сохранять порядок ключей outer: использовать объединение ключей из обеих таблиц, аналогично полному внешнему соединению в SQL; сортировать ключи лексикографически inner: использовать пересечение ключей из обеих таблиц, аналогично внутреннему соединению в SQL; сохранять порядок ключей левой таблицы on : метка или список Имена полей для объединения. Должны присутствовать в обеих таблицах. Если on равно None и объединение не выполняется по индексам, по умолчанию объединение выполняется по пересечению столбцов. left_on : метка или список, или массив-подобный объект Имена полей для объединения в левой таблице DataFrame. Может быть вектором или списком векторов длины DataFrame для использования определенного вектора в качестве ключа объединения вместо столбцов right_on : метка или список, или массив-подобный объект Имена полей для объединения в правой таблице DataFrame или вектор/список векторов по документации left_on left_index : boolean, по умолчанию False Использовать индекс из левой таблицы DataFrame в качестве ключа(ей) объединения. Если это MultiIndex, количество ключей в другой таблице (либо индекс, либо количество столбцов) должно совпадать с количеством уровней right_index : boolean, по умолчанию False Использовать индекс из правой таблицы DataFrame в качестве ключа объединения. Те же оговорки, что и для left_index sort : boolean, по умолчанию False Сортировать ключи объединения лексикографически в результирующей таблице DataFrame. Если False, порядок ключей объединения зависит от типа объединения (ключевое слово how) suffixes : последовательность длины 2 (кортеж, список, ...) Суффикс, применяемый к совпадающим именам столбцов в левой и правой части, соответственно copy : boolean, по умолчанию True Если False, данные не копируются избыточно indicator : boolean или строка, по умолчанию False Если True, добавляет столбец в выходную таблицу DataFrame под названием “_merge” с информацией о источнике каждой строки. Если строка, столбец с информацией о источнике каждой строки будет добавлен в выходную таблицу DataFrame, и столбец будет назван значением строки. Столбец информации является типа Categorical и принимает значение “left_only” для наблюдений, ключ объединения которых присутствует только в левой таблице, “right_only” для наблюдений, ключ объединения которых присутствует только в правой таблице, и “both”, если ключ объединения наблюдения найден в обеих таблицах. Добавлена в версии 0.17.0. validate : строка, по умолчанию None Если указано, проверяет, является ли объединение заданного типа. “one_to_one” или “1:1”: проверить, уникальны ли ключи объединения в обоих наборах данных. “one_to_many” или “1:m”: проверить, уникальны ли ключи объединения в левом наборе данных. “many_to_one” или “m:1”: проверить, уникальны ли ключи объединения в правом наборе данных. “many_to_many” или “m:m”: разрешено, но не приводит к проверкам. Добавлена в версии 0.21.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