polars.sql_expr

polars.sql_expr(
    sql: str | Sequence[str],
) → Expr | list[Expr]

Разбирает одно или несколько SQL-выражений в выражение или выражения Polars.

Параметры:

sql

Одно или несколько SQL-выражений.

Примеры

Разбор одного SQL-выражения:

>>> df = pl.DataFrame({"a": [2, 1]})
>>> expr = pl.sql_expr("MAX(a)")
>>> df.select(expr)
shape: (1, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 2   │
└─────┘

Разбор нескольких SQL-выражений:

>>> df.with_columns(
...     *pl.sql_expr(["POWER(a,a) AS a_a", "CAST(a AS TEXT) AS a_txt"]),
... )
shape: (2, 3)
┌─────┬─────┬───────┐
│ a   ┆ a_a ┆ a_txt │
│ --- ┆ --- ┆ ---   │
│ i64 ┆ i64 ┆ str   │
╞═════╪═════╪═══════╡
│ 2   ┆ 4   ┆ 2     │
│ 1   ┆ 1   ┆ 1     │
└─────┴─────┴───────┘