pandas.Series.to_pickle

Series.to_pickle(path, compression='infer', protocol=5, storage_options=None)[source]

Сохранение объекта в файл с помощью Pickle (сериализация).

Параметры

path:строка, объект пути или файл-подобный объект

Строка, объект пути (реализующий os.PathLike[str]) или файл-подобный объект, реализующий бинарную функцию write(). Путь к файлу, в котором будет сохранён сериализованный объект.

compression:строка или словарь, по умолчанию ‘infer’

Для сжатия выходных данных «на лету». Если ‘infer’ и ‘path’ — путь к файлу, то определяется сжатие по следующим расширениям: ‘.gz’, ‘.bz2’, ‘.zip’, ‘.xz’, ‘.zst’, ‘.tar’, ‘.tar.gz’, ‘.tar.xz’ или ‘.tar.bz2’ (в противном случае сжатие не применяется). Устанавливается в None для отсутствия сжатия. Также может быть словарем с ключом 'method', установленным в значение из {'zip', 'gzip', 'bz2', 'zstd', 'tar'}, а остальные пары ключ-значение передаются в zipfile.ZipFile, gzip.GzipFile, bz2.BZ2File, zstandard.ZstdCompressor или tarfile.TarFile, соответственно. Например, для более быстрого сжатия и создания воспроизводимого gzip-архива можно передать следующее: compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}.

Добавлена в версии 1.5.0: Поддержка файлов .tar.

protocol:целое число

Целое число, указывающее протокол, который должен быть использован сериализатором, по умолчанию HIGHEST_PROTOCOL (см. [1] пункт 12.1.2). Возможные значения: 0, 1, 2, 3, 4, 5. Отрицательное значение параметра protocol эквивалентно установке его значения в HIGHEST_PROTOCOL.

1

https://docs.python.org/3/library/pickle.html.

storage_options:словарь, необязательно

Дополнительные опции, уместные для определённого подключения к хранилищу, например, хост, порт, имя пользователя, пароль и т. д. Для URL-адресов HTTP(S) пары ключ-значение передаются в urllib.request.Request в качестве параметров заголовка. Для других URL-адресов (например, начинающихся с «s3://» и «gcs://») пары ключ-значение передаются в fsspec.open. Подробности см. в fsspec и urllib, а дополнительные примеры опций хранения см. здесь.

Добавлена в версии 1.2.0.

См. также

read_pickle

Загрузка сериализованного объекта pandas (или любого объекта) из файла.

DataFrame.to_hdf

Запись DataFrame в HDF5-файл.

DataFrame.to_sql

Запись DataFrame в базу данных SQL.

DataFrame.to_parquet

Запись DataFrame в двоичный формат parquet.

Примеры

>>> original_df = pd.DataFrame({"foo": range(5), "bar": range(5, 10)})  
>>> original_df  
   foo  bar
0    0    5
1    1    6
2    2    7
3    3    8
4    4    9
>>> original_df.to_pickle("./dummy.pkl")  

>>> unpickled_df = pd.read_pickle("./dummy.pkl")  
>>> unpickled_df  
   foo  bar
0    0    5
1    1    6
2    2    7
3    3    8
4    4    9