Settings to use for read_orc(). More...

#include <orc.hpp>

Public Member Functions
	orc_reader_options ()=default
	Default constructor. More...

source_info const &	get_source () const
	Returns source info. More...

auto const &	get_columns () const
	Returns names of the columns to read, if set. More...

auto const &	get_stripes () const
	Returns vector of vectors, stripes to read for each input source. More...

int64_t	get_skip_rows () const
	Returns number of rows to skip from the start. More...

std::optional< int64_t > const &	get_num_rows () const
	Returns number of row to read. More...

bool	is_enabled_use_index () const
	Whether to use row index to speed-up reading. More...

bool	is_enabled_use_np_dtypes () const
	Whether to use numpy-compatible dtypes. More...

data_type	get_timestamp_type () const
	Returns timestamp type to which timestamp column will be cast. More...

std::vector< std::string > const &	get_decimal128_columns () const
	Returns fully qualified names of columns that should be read as 128-bit Decimal. More...

void	set_columns (std::vector< std::string > col_names)
	Sets names of the column to read. More...

void	set_stripes (std::vector< std::vector< size_type >> stripes)
	Sets list of stripes to read for each input source. More...

void	set_skip_rows (int64_t rows)
	Sets number of rows to skip from the start. More...

void	set_num_rows (int64_t nrows)
	Sets number of row to read. More...

void	enable_use_index (bool use)
	Enable/Disable use of row index to speed-up reading. More...

void	enable_use_np_dtypes (bool use)
	Enable/Disable use of numpy-compatible dtypes. More...

void	set_timestamp_type (data_type type)
	Sets timestamp type to which timestamp column will be cast. More...

void	set_decimal128_columns (std::vector< std::string > val)
	Set columns that should be read as 128-bit Decimal. More...

Static Public Member Functions
static orc_reader_options_builder	builder (source_info src)
	Creates `orc_reader_options_builder` which will build `orc_reader_options`. More...

Detailed Description

Settings to use for read_orc().

Definition at line 53 of file orc.hpp.

Constructor & Destructor Documentation

◆ orc_reader_options()

cudf::io::orc_reader_options::orc_reader_options ( )

default

Default constructor.

This has been added since Cython requires a default constructor to create objects on stack.

Member Function Documentation

◆ builder()

static orc_reader_options_builder cudf::io::orc_reader_options::builder ( source_info src )

static

Creates orc_reader_options_builder which will build orc_reader_options.

Parameters

src	Source information to read orc file

Returns: Builder to build reader options

◆ enable_use_index()

void cudf::io::orc_reader_options::enable_use_index ( bool use )

inline

Enable/Disable use of row index to speed-up reading.

Parameters

use	Boolean value to enable/disable row index use

Definition at line 231 of file orc.hpp.

◆ enable_use_np_dtypes()

void cudf::io::orc_reader_options::enable_use_np_dtypes ( bool use )

inline

Enable/Disable use of numpy-compatible dtypes.

Parameters

use	Boolean value to enable/disable

Definition at line 238 of file orc.hpp.

◆ get_columns()

auto const& cudf::io::orc_reader_options::get_columns ( ) const

inline

Returns names of the columns to read, if set.

Returns: Names of the columns to read; nullopt if the option is not set

Definition at line 114 of file orc.hpp.

◆ get_decimal128_columns()

std::vector<std::string> const& cudf::io::orc_reader_options::get_decimal128_columns ( ) const

inline

Returns fully qualified names of columns that should be read as 128-bit Decimal.

Returns: Fully qualified names of columns that should be read as 128-bit Decimal

Definition at line 164 of file orc.hpp.

◆ get_num_rows()

std::optional<int64_t> const& cudf::io::orc_reader_options::get_num_rows ( ) const

inline

Returns number of row to read.

Returns: Number of rows to read; nullopt if the option hasn't been set (in which case the file is read until the end)

Definition at line 136 of file orc.hpp.

◆ get_skip_rows()

int64_t cudf::io::orc_reader_options::get_skip_rows ( ) const

inline

Returns number of rows to skip from the start.

Returns: Number of rows to skip from the start

Definition at line 128 of file orc.hpp.

◆ get_source()

source_info const& cudf::io::orc_reader_options::get_source ( ) const

inline

Returns source info.

Returns: Source info

Definition at line 107 of file orc.hpp.

◆ get_stripes()

auto const& cudf::io::orc_reader_options::get_stripes ( ) const

inline

Returns vector of vectors, stripes to read for each input source.

Returns: Vector of vectors, stripes to read for each input source

Definition at line 121 of file orc.hpp.

◆ get_timestamp_type()

data_type cudf::io::orc_reader_options::get_timestamp_type ( ) const

inline

Returns timestamp type to which timestamp column will be cast.

Returns: Timestamp type to which timestamp column will be cast

Definition at line 157 of file orc.hpp.

◆ is_enabled_use_index()

bool cudf::io::orc_reader_options::is_enabled_use_index ( ) const

inline

Whether to use row index to speed-up reading.

Returns: true if row index is used to speed-up reading

Definition at line 143 of file orc.hpp.

◆ is_enabled_use_np_dtypes()

bool cudf::io::orc_reader_options::is_enabled_use_np_dtypes ( ) const

inline

Whether to use numpy-compatible dtypes.

Returns: true if numpy-compatible dtypes are used

Definition at line 150 of file orc.hpp.

◆ set_columns()

void cudf::io::orc_reader_options::set_columns ( std::vector< std::string > col_names )

inline

Sets names of the column to read.

Parameters

col_names Vector of column names

Definition at line 176 of file orc.hpp.

◆ set_decimal128_columns()

void cudf::io::orc_reader_options::set_decimal128_columns ( std::vector< std::string > val )

inline

Set columns that should be read as 128-bit Decimal.

Parameters

val	Vector of fully qualified column names

Definition at line 252 of file orc.hpp.

◆ set_num_rows()

void cudf::io::orc_reader_options::set_num_rows ( int64_t nrows )

inline

Sets number of row to read.

Parameters

nrows Number of rows

Exceptions

cudf::logic_error	if a negative value is passed
cudf::logic_error	if stripes have been previously set

Definition at line 219 of file orc.hpp.

◆ set_skip_rows()

void cudf::io::orc_reader_options::set_skip_rows ( int64_t rows )

inline

Sets number of rows to skip from the start.

Parameters

rows	Number of rows

Exceptions

cudf::logic_error	if a negative value is passed
cudf::logic_error	if stripes have been previously set

Definition at line 204 of file orc.hpp.

◆ set_stripes()

void cudf::io::orc_reader_options::set_stripes ( std::vector< std::vector< size_type >> stripes )

inline

Sets list of stripes to read for each input source.

Parameters

stripes Vector of vectors, mapping stripes to read to input sources

Exceptions

cudf::logic_error	if a non-empty vector is passed, and `skip_rows` has been previously set
cudf::logic_error	if a non-empty vector is passed, and `num_rows` has been previously set

Definition at line 188 of file orc.hpp.

◆ set_timestamp_type()

void cudf::io::orc_reader_options::set_timestamp_type ( data_type type )

inline

Sets timestamp type to which timestamp column will be cast.

Parameters

type	Type of timestamp

Definition at line 245 of file orc.hpp.

The documentation for this class was generated from the following file:

orc.hpp

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ orc_reader_options()

Member Function Documentation

◆ builder()

◆ enable_use_index()

◆ enable_use_np_dtypes()

◆ get_columns()

◆ get_decimal128_columns()

◆ get_num_rows()

◆ get_skip_rows()

◆ get_source()

◆ get_stripes()

◆ get_timestamp_type()

◆ is_enabled_use_index()

◆ is_enabled_use_np_dtypes()

◆ set_columns()

◆ set_decimal128_columns()

◆ set_num_rows()

◆ set_skip_rows()

◆ set_stripes()

◆ set_timestamp_type()