pandas.read_hdf

pandas.read_hdf(path_or_buf, key=None, mode='r', errors='strict', where=None, start=None, stop=None, columns=None, iterator=False, chunksize=None, **kwargs)[source]

Чтение из хранилища, закрытие его, если оно было открыто.

Получение объекта pandas, сохраненного в файле, необязательно на основе критериев where.

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

Pandas использует PyTables для чтения и записи файлов HDF5, что позволяет сериализовать данные типа object с помощью pickle при использовании формата «fixed». Загрузка данных с pickle, полученных из ненадежных источников, может быть небезопасной.

См.: https://docs.python.org/3/library/pickle.html для более подробной информации.

Параметры:

path_or_buf:str, объект пути, pandas.HDFStore

Приемлемый любой допустимый путь к файлу. Поддерживается только локальная файловая система, удаленные URL-адреса и объекты типа файл не поддерживаются.

Если вы хотите передать объект пути, pandas принимает любой os.PathLike.

В качестве альтернативы pandas принимает открытый pandas.HDFStore объект.

key:объект, необязательно

Идентификатор группы в хранилище. Может быть опущен, если HDF-файл содержит один объект pandas.

mode:{‘r’, ‘r+’, ‘a’}, по умолчанию ‘r’

Режим использования при открытии файла. Игнорируется, если path_or_buf является pandas.HDFStore. По умолчанию ‘r’.

errors:строка, по умолчанию ‘strict’

Указывает, как обрабатывать ошибки кодирования и декодирования. См. аргумент errors для open() для полного списка вариантов.

where:список, необязательно

Список объектов Term (или преобразуемых к ним).

start:целое число, необязательно

Номер строки для начала выбора.

stop:целое число, необязательно

Номер строки для окончания выбора.

columns:список, необязательно

Список имен столбцов для возврата.

iterator:bool, необязательно

Возвращение объекта итератора.

chunksize:целое число, необязательно

Количество строк, включаемых в итерацию при использовании итератора.

**kwargs

Дополнительные ключевые аргументы, передаваемые в HDFStore.

Возвращаемое значение:

объект

Выбранный объект. Тип возвращаемого значения зависит от сохраненного объекта.

См. также

DataFrame.to_hdf

Запись файла HDF из DataFrame.

HDFStore

Доступ к HDF-файлам на низком уровне.

Примеры

>>> df = pd.DataFrame([[1, 1.0, 'a']], columns=['x', 'y', 'z'])  
>>> df.to_hdf('./store.h5', 'data')  
>>> reread = pd.read_hdf('./store.h5')