polars.LazyFrame.deserialize

classmethod LazyFrame.deserialize(
    source: str | bytes | Path | IOBase,
    *,
    format: SerializationFormat = 'binary',
) → LazyFrame

Читает логический план из файла для создания LazyFrame.

Параметры:

source

Путь к файлу или файловоподобный объект (под файловоподобными объектами подразумеваются объекты, у которых есть метод read(), например файловый дескриптор (например, полученный с помощью встроенной функции open) или BytesIO).

format

Формат, в котором был сериализован LazyFrame. Варианты:

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

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

Эта функция использует pickle, если логический план содержит пользовательские функции Python (UDF), и поэтому наследует связанные с этим последствия для безопасности. Десериализация может выполнять произвольный код, поэтому ее следует выполнять только для доверенных данных.

См. также

LazyFrame.serialize

Примечания

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

Примеры

>>> import io
>>> lf = pl.LazyFrame({"a": [1, 2, 3]}).sum()
>>> bytes = lf.serialize()
>>> pl.LazyFrame.deserialize(io.BytesIO(bytes)).collect()
shape: (1, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 6   │
└─────┘