pandas.read_orc

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

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

Параметры:

path:str, path object, or file-like object

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

columns:list, default None

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

dtype_backend:{‘numpy_nullable’, ‘pyarrow’}, default ‘numpy_nullable’

Тип данных внутреннего механизма, применяемый к результирующему DataFrame (функция пока экспериментальная). Поведение описано ниже:

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

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

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

filesystem:fsspec or pyarrow filesystem, default 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")