polars.DataFrame.serialize

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

Сериализует этот DataFrame в файл или строку в формате JSON.

Параметры:

file

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

format

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

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

Примечания

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

Примеры

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

>>> df = pl.DataFrame(
...     {
...         "foo": [1, 2, 3],
...         "bar": [6, 7, 8],
...     }
... )
>>> bytes = df.serialize()
>>> type(bytes)
<class 'bytes'>

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

>>> import io
>>> pl.DataFrame.deserialize(io.BytesIO(bytes))
shape: (3, 2)
┌─────┬─────┐
│ foo ┆ bar │
│ --- ┆ --- │
│ i64 ┆ i64 │
╞═════╪═════╡
│ 1   ┆ 6   │
│ 2   ┆ 7   │
│ 3   ┆ 8   │
└─────┴─────┘