pandas.read_hdf#

pandas.read_hdf(path_or_buf, ключ=None, mode='r', ошибки='strict', где=None, начало=None, стоп=None, столбцы=None, итератор=False, chunksize=None, **kwargs)[источник]#

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

Извлечь объект pandas, сохраненный в файле, опционально на основе критериев where.

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

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

См.: https://docs.python.org/3/library/pickle.html подробнее.

Параметры:

path_or_bufstr, объект пути, pandas.HDFStore

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

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

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

ключобъект, опционально

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

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

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

ошибкиstr, по умолчанию 'strict'

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

гдесписок, необязательный

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

началоint, необязательный

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

стопint, необязательный

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

столбцысписок, необязательный

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

итераторbool, необязательно

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

chunksizeint, необязательный

Количество строк для включения в итерацию при использовании итератора.

**kwargs

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

Возвращает:

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

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

DataFrame.to_hdf: Запись HDF-файла из DataFrame.
HDFStore: Низкоуровневый доступ к HDF-файлам.

Примечания

Когда errors="surrogatepass", pd.options.future.infer_string если истинно, и PyArrow установлен, если при декодировании в UTF-8 встречается суррогат UTF-16, результирующий dtype будет pd.StringDtype(storage="python", na_value=np.nan).

Примеры

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