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

Объединение DataFrame или именованных Series объектов с помощью объединения в стиле базы данных.

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

Параметры:

left : DataFrame right : DataFrame or named Series Объект для объединения. how : {‘left’, ‘right’, ‘outer’, ‘inner’}, default ‘inner’ Тип объединения, который необходимо выполнить. left: использовать только ключи из левой таблицы, аналогично левому внешнему объединению SQL; сохранить порядок ключей. right: использовать только ключи из правой таблицы, аналогично правому внешнему объединению SQL; сохранить порядок ключей. outer: использовать объединение ключей из обеих таблиц, аналогично полному внешнему объединению SQL; отсортировать ключи лексикографически. inner: использовать пересечение ключей из обеих таблиц, аналогично внутреннему объединению SQL; сохранить порядок ключей левой таблицы. on : label or list Названия столбцов или уровней индекса для объединения. Они должны быть найдены в обеих DataFrame. Если on равно None и объединение не выполняется по индексам, то по умолчанию используется пересечение столбцов в обеих DataFrame. left_on : label or list, or array-like Названия столбцов или уровней индекса для объединения в левой DataFrame. Также может быть массивом или списком массивов длиной левой DataFrame. Эти массивы обрабатываются так, как если бы они были столбцами. right_on : label or list, or array-like Названия столбцов или уровней индекса для объединения в правой DataFrame. Также может быть массивом или списком массивов длиной правой DataFrame. Эти массивы обрабатываются так, как если бы они были столбцами. left_index : bool, default False Использовать индекс из левой DataFrame в качестве ключа(ей) объединения. Если это MultiIndex, количество ключей в другой DataFrame (либо индекс, либо количество столбцов) должно соответствовать количеству уровней. right_index : bool, default False Использовать индекс из правой DataFrame в качестве ключа объединения. Те же оговорки, что и для left_index. sort : bool, default False Отсортировать ключи объединения лексикографически в результирующем DataFrame. Если False, порядок ключей объединения зависит от типа объединения (ключевое слово how). suffixes : tuple of (str, str), default (‘_x’, ‘_y’) Суффикс, который необходимо добавить к совпадающим именам столбцов в левой и правой сторонах соответственно. Для поднятия исключения при совпадающих столбцах используйте (False, False). copy : bool, default True Если False, избегать копирования, если это возможно. indicator : bool or str, default False Если True, добавляет столбец в результирующий DataFrame под названием “_merge” с информацией о источнике каждой строки. Если строка, столбец с информацией о источнике каждой строки будет добавлен в результирующий DataFrame, и столбец будет назван значением строки. Столбец информации является категориального типа и принимает значение “left_only” для наблюдений, чьи ключи объединения встречаются только в левой DataFrame, “right_only” для наблюдений, чьи ключи объединения встречаются только в правой DataFrame, и “both”, если ключ объединения наблюдения встречается в обеих DataFrame. validate : str, optional Если указано, проверяет, является ли объединение указанного типа. “one_to_one” или “1:1”: проверить, являются ли ключи объединения уникальными в обеих наборах данных. “one_to_many” или “1:m”: проверить, являются ли ключи объединения уникальными в левом наборе данных. “many_to_one” или “m:1”: проверить, являются ли ключи объединения уникальными в правом наборе данных. “many_to_many” или “m:m”: разрешено, но не приводит к проверкам. New in version 0.21.0.

Возвращает:

DataFrame DataFrame объединённых объектов.

См. также

merge_ordered

Объединение с необязательной заливкой/интерполяцией.

merge_asof

Объединение по ближайшим ключам.

DataFrame.join

Аналогичный метод, использующий индексы.

Примечания

Поддержка указания уровней индексов в качестве on, left_on, и right_on параметров была добавлена в версии 0.23.0. Поддержка объединения именованных Series объектов была добавлена в версии 0.24.0

Примеры

>>> df1 = pd.DataFrame({'lkey': ['foo', 'bar', 'baz', 'foo'],
...                     'value': [1, 2, 3, 5]})
>>> df2 = pd.DataFrame({'rkey': ['foo', 'bar', 'baz', 'foo'],
...                     'value': [5, 6, 7, 8]})
>>> df1
    lkey value
0   foo      1
1   bar      2
2   baz      3
3   foo      5
>>> df2
    rkey value
0   foo      5
1   bar      6
2   baz      7
3   foo      8

Объединение df1 и df2 по столбцам lkey и rkey. Столбцы значений имеют по умолчанию добавленные суффиксы _x и _y.

>>> df1.merge(df2, left_on='lkey', right_on='rkey')
  lkey  value_x rkey  value_y
0  foo        1  foo        5
1  foo        1  foo        8
2  foo        5  foo        5
3  foo        5  foo        8
4  bar        2  bar        6
5  baz        3  baz        7

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

>>> df1.merge(df2, left_on='lkey', right_on='rkey',
...           suffixes=('_left', '_right'))
  lkey  value_left rkey  value_right
0  foo           1  foo            5
1  foo           1  foo            8
2  foo           5  foo            5
3  foo           5  foo            8
4  bar           2  bar            6
5  baz           3  baz            7

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

>>> df1.merge(df2, left_on='lkey', right_on='rkey', suffixes=(False, False))
Traceback (most recent call last):
...
ValueError: columns overlap but no suffix specified:
    Index(['value'], dtype='object')