Метод to_pickle

Метод to_pickle применяется к DataFrame и сохраняет его в бинарный файл с расширением .pkl (pickle). Первым параметром передаётся путь к файлу для сохранения. Метод не возвращает значений, а только записывает данные на диск. Pickle-формат позволяет сохранять не только данные, но и всю структуру DataFrame, включая индексы, названия столбцов и типы данных.

Синтаксис

df.to_pickle(filepath)

Пример

Давайте сохраним таблицу в файл с помощью метода to_pickle:

import pandas as pd

df = pd.DataFrame({
	'a': [1, 2, 3, 4, 5],
	'b': [10, 20, 30, 40, 50]
})
df.to_pickle('data.pkl')

После выполнения этого кода в текущей директории появится файл data.pkl, содержащий сохранённую таблицу.

Пример

Давайте загрузим сохранённый файл обратно с помощью функции read_pickle:

import pandas as pd

df = pd.read_pickle('data.pkl')
print(df)

Результат выполнения кода:

Как видите, данные полностью восстановились вместе со структурой таблицы.

Пример

Метод to_pickle поддерживает различные протоколы сериализации через параметр protocol. По умолчанию используется протокол 4:

import pandas as pd

df = pd.DataFrame({
	'a': [1, 2, 3, 4, 5],
	'b': [10, 20, 30, 40, 50]
})
df.to_pickle('data.pkl', protocol=4)

Параметр protocol может принимать значения от 0 до 4, где более высокий протокол даёт лучшую производительность и совместимость.

Смотрите также

функция read_pickle,
которая загружает DataFrame из pickle-файла
метод to_csv,
который сохраняет таблицу в CSV-файл
метод to_parquet,
который сохраняет данные в формате Parquet
метод to_json,
который сохраняет таблицу в JSON-формат