polars.DataFrame.write_ndjson

DataFrame.write_ndjson(
    file: str | Path | IO[bytes] | IO[str] | None = None,
    *,
    compression: Literal['uncompressed',
    'gzip',
    'zstd'] = 'uncompressed',
    compression_level: int | None = None,
    check_extension: bool = True,
) → str | None

Сериализовать в представление JSON с разделителями в виде символов новой строки.

Параметры:

file

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

compression

Формат сжатия.

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

Эта функциональность считается нестабильной. Она может быть изменена в любой момент без того, чтобы это считалось нарушением обратной совместимости.

compression_level

Уровень сжатия: обычно от 0 до 9 или None, чтобы позволить движку выбрать его самостоятельно.

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

Эта функциональность считается нестабильной. Она может быть изменена в любой момент без того, чтобы это считалось нарушением обратной совместимости.

check_extension

Проверять ли соответствие имени файла настройкам сжатия. Будет вызвана ошибка, если для compression задано значение ‘uncompressed’, а имя файла заканчивается на одно из значений (“.gz”, “.zst”, “.zstd”), или если compression != ‘uncompressed’, а расширение файла не соответствует настройкам. Применяется только в том случае, если file — это путь.

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

Эта функциональность считается нестабильной. Она может быть изменена в любой момент без того, чтобы это считалось нарушением обратной совместимости.

Примеры

>>> df = pl.DataFrame(
...     {
...         "foo": [1, 2, 3],
...         "bar": [6, 7, 8],
...     }
... )
>>> df.write_ndjson()
'{"foo":1,"bar":6}\n{"foo":2,"bar":7}\n{"foo":3,"bar":8}\n'