polars.DataFrame.extend

DataFrame.extend(
    other: DataFrame,
) → DataFrame

Расширяет память, используемую этим DataFrame, значениями из other.

В отличие от vstack, который добавляет чанки из other к чанкам этого DataFrame, extend добавляет данные из other в базовые области памяти и поэтому может привести к перераспределению памяти.

Если перераспределения памяти не происходит, результирующая структура данных не будет содержать дополнительных чанков, что обеспечит более быстрое выполнение запросов.

Предпочитайте extend вместо vstack, если после однократного добавления данных нужно выполнить запрос. Например, при онлайн-операциях, когда вы добавляете n строк и повторно выполняете запрос.

Предпочитайте vstack вместо extend, если нужно многократно добавлять данные перед выполнением запроса. Например, при чтении нескольких файлов, данные из которых нужно сохранить в одном DataFrame. В последнем случае завершите последовательность операций vstack вызовом rechunk.

Параметры:

other

DataFrame, который нужно добавить по вертикали.

Предупреждение

Этот метод изменяет DataFrame на месте. DataFrame возвращается только для удобства.

См. также

vstack

Примеры

>>> df1 = pl.DataFrame({"foo": [1, 2, 3], "bar": [4, 5, 6]})
>>> df2 = pl.DataFrame({"foo": [10, 20, 30], "bar": [40, 50, 60]})
>>> df1.extend(df2)
shape: (6, 2)
┌─────┬─────┐
│ foo ┆ bar │
│ --- ┆ --- │
│ i64 ┆ i64 │
╞═════╪═════╡
│ 1   ┆ 4   │
│ 2   ┆ 5   │
│ 3   ┆ 6   │
│ 10  ┆ 40  │
│ 20  ┆ 50  │
│ 30  ┆ 60  │
└─────┴─────┘