pandas.read_orc

pandas.read_orc(path, columns=None, dtype_backend=_NoDefault.no_default, filesystem=None, **kwargs)[source]

Загрузка объекта ORC из файла по пути, возвращая DataFrame.

Параметры:

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

Строка, объект пути (реализующий os.PathLike[str]), или объект-подобный файлу, реализующий бинарную read() функцию. Строка может быть URL. Поддерживаемые схемы URL включают http, ftp, s3 и file. Для URL файлов ожидается хост. Локальный файл может быть: file://localhost/path/to/table.orc.

columns:список, по умолчанию None

Если не None, будут считаны только эти столбцы из файла. Вывод всегда следует порядку в файле, а не списку столбцов. Это отражает исходное поведение pyarrow.orc.ORCFile.read().

dtype_backend:{‘numpy_nullable’, ‘pyarrow’}, по умолчанию ‘numpy_nullable’

Обработка типа данных, применяемая к результирующему DataFrame (ещё экспериментально). Поведение следующее:

• "numpy_nullable": возвращает DataFrame с поддержкой типа данных с возможностью NULL (по умолчанию).

• "pyarrow": возвращает DataFrame с типом данных pyarrow, поддерживающий NULL, ArrowDtype.

В версии 2.0.

filesystem:fsspec или pyarrow filesystem, по умолчанию None

Объект файловой системы для чтения файла parquet.

В версии 2.1.0.

**kwargs

Любые дополнительные kwargs передаются pyarrow.

Возвращает:

DataFrame

Примечания

Перед использованием этой функции необходимо прочитать руководство пользователя по ORC и установить дополнительные зависимости.

Если path — это схема URI, указывающая на локальный или удаленный файл (например, “s3://”), будет попытка использовать pyarrow.fs файловую систему для чтения файла. Вы также можете передать объект pyarrow или fsspec файловой системы в параметр filesystem, чтобы переопределить это поведение.

Примеры

>>> result = pd.read_orc("example_pa.orc")