polars.LazyFrame.serialize

LazyFrame.serialize(
    file: IOBase | str | Path | None = None,
    *,
    format: SerializationFormat = 'binary',
) → bytes | str | None

Сериализует логический план этого LazyFrame в файл или строку в формате JSON.

Параметры:

file

Путь к файлу, в который следует записать результат. Если задано значение None (по умолчанию), результат возвращается в виде строки.

format

Формат сериализации. Возможные варианты:

• "binary": сериализация в двоичный формат (байты). Используется по умолчанию.
• "json": сериализация в формат JSON (строка) (устарело).

См. также

LazyFrame.deserialize

Примечания

Сериализация нестабильна между версиями Polars: LazyFrame, сериализованный в одной версии Polars, может не десериализоваться в другой.

Примеры

Сериализация логического плана в двоичное представление.

>>> lf = pl.LazyFrame({"a": [1, 2, 3]}).sum()
>>> bytes = lf.serialize()

Позже байты можно десериализовать обратно в LazyFrame.

>>> import io
>>> pl.LazyFrame.deserialize(io.BytesIO(bytes)).collect()
shape: (1, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 6   │
└─────┘