polars.LazyFrame.rename

LazyFrame.rename(
    mapping: Mapping[str,
    str] | Callable[[str],
    str],
    *,
    strict: bool = True,
) → LazyFrame

Переименовать имена столбцов.

движок:В памятиПотоковыйРаспределённый

Параметры:

mapping

Пары «ключ — значение», сопоставляющие старые имена новым, либо функция, которая принимает старое имя и возвращает новое.

strict

Проверять, что все имена столбцов существуют в текущей схеме, и выбрасывать исключение, если какие-либо из них отсутствуют. (Обратите внимание, что этот параметр ничего не делает, если в mapping передана функция.)

См. также

Expr.name.replace

Примечания

Если существующие имена поменять местами (например, «A» указывает на «B», а «B» — на «A»), Polars заблокирует проталкивание проекций и предикатов на этом узле.

Примеры

>>> lf = pl.LazyFrame(
...     {
...         "foo": [1, 2, 3],
...         "bar": [6, 7, 8],
...         "ham": ["a", "b", "c"],
...     }
... )
>>> lf.rename({"foo": "apple"}).collect()
shape: (3, 3)
┌───────┬─────┬─────┐
│ apple ┆ bar ┆ ham │
│ ---   ┆ --- ┆ --- │
│ i64   ┆ i64 ┆ str │
╞═══════╪═════╪═════╡
│ 1     ┆ 6   ┆ a   │
│ 2     ┆ 7   ┆ b   │
│ 3     ┆ 8   ┆ c   │
└───────┴─────┴─────┘
>>> lf.rename(lambda column_name: "c" + column_name[1:]).collect()
shape: (3, 3)
┌─────┬─────┬─────┐
│ coo ┆ car ┆ cam │
│ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ str │
╞═════╪═════╪═════╡
│ 1   ┆ 6   ┆ a   │
│ 2   ┆ 7   ┆ b   │
│ 3   ┆ 8   ┆ c   │
└─────┴─────┴─────┘