ParquetFilter Class Reference

Typed filter builder for parquet-backed datasets. More...

#include <OpenMS/FORMAT/ParquetFilter.h>

Collaboration diagram for ParquetFilter:

Public Member Functions
	ParquetFilter ()=default
	ParquetFilter (const ParquetFilter &)=default
ParquetFilter &	andNext ()
	Combine the next condition with logical AND.
ParquetFilter &	orNext ()
	Combine the next condition with logical OR.
ParquetFilter &	eq (const String &column, Int64 value)
	Add an equality condition for an integer column.
ParquetFilter &	ne (const String &column, Int64 value)
	Add an inequality condition for an integer column.
ParquetFilter &	lt (const String &column, Int64 value)
	Add a less-than condition for an integer column.
ParquetFilter &	le (const String &column, Int64 value)
	Add a less-than-or-equal condition for an integer column.
ParquetFilter &	gt (const String &column, Int64 value)
	Add a greater-than condition for an integer column.
ParquetFilter &	ge (const String &column, Int64 value)
	Add a greater-than-or-equal condition for an integer column.
ParquetFilter &	in (const String &column, const std::vector< Int64 > &values)
	Add an IN condition for an integer column.
ParquetFilter &	eq (const String &column, const String &value)
	Add an equality condition for a string column.
ParquetFilter &	ne (const String &column, const String &value)
	Add an inequality condition for a string column.
ParquetFilter &	lt (const String &column, const String &value)
	Add a less-than condition for a string column.
ParquetFilter &	le (const String &column, const String &value)
	Add a less-than-or-equal condition for a string column.
ParquetFilter &	gt (const String &column, const String &value)
	Add a greater-than condition for a string column.
ParquetFilter &	ge (const String &column, const String &value)
	Add a greater-than-or-equal condition for a string column.
ParquetFilter &	in (const String &column, const std::vector< String > &values)
	Add an IN condition for a string column.
const FilterExpression &	expression () const
	Return the filter expression.
bool	empty () const
	Check if the filter is empty (has no conditions).

Static Public Member Functions
static FilterExpression	merge (const FilterExpression &lhs, const FilterExpression &rhs, const String &connector="AND")
	Merge two filter expressions with a connector.

Private Member Functions
ParquetFilter &	addCondition_ (const String &column, const String &op, ColumnType type, const std::vector< String > &values)

Private Attributes
FilterExpression	expr_
String	next_connector_ {"AND"}

Detailed Description

Typed filter builder for parquet-backed datasets.

This builder provides a structured alternative to string-encoded filters. It is intended for use in Parquet-backed readers (e.g., XICParquetFile) to construct filter expressions that can be pushed down to Arrow Dataset scanners or evaluated in-memory if pushdown is unavailable.

Conditions are combined left-to-right. Use andNext()/orNext() to control how consecutive conditions are connected (default is AND).

Example

using namespace OpenMS;
 
ParquetFilter f;
f.eq("PRECURSOR_ID", 1318)
 .andNext()
 .eq("ANNOTATION", "y3^1");
 
// Use f.expression() to pass into a parquet reader, or pass the builder
// directly when supported.

Constructor & Destructor Documentation

ParquetFilter() [1/2]

ParquetFilter ( )

default

ParquetFilter() [2/2]

ParquetFilter ( const ParquetFilter &  )

default

Member Function Documentation

addCondition_()

ParquetFilter & addCondition_ ( const String &  column, const String &  op, ColumnType  type, const std::vector< String > &  values  )

private

andNext()

ParquetFilter & andNext

(

)

Combine the next condition with logical AND.

empty()

bool empty

(

)

const

Check if the filter is empty (has no conditions).

Returns

True if the filter has no conditions.

eq() [1/2]

ParquetFilter & eq	(	const String &	column,
		const String &	value
	)

Add an equality condition for a string column.

Parameters

column	Column name.
value	String value to compare.

eq() [2/2]

ParquetFilter & eq	(	const String &	column,
		Int64	value
	)

Add an equality condition for an integer column.

Parameters

column	Column name.
value	Integer value to compare.

expression()

const FilterExpression & expression

(

)

const

Return the filter expression.

Returns

The constructed filter expression.

ge() [1/2]

ParquetFilter & ge	(	const String &	column,
		const String &	value
	)

Add a greater-than-or-equal condition for a string column.

Parameters

column	Column name.
value	String value to compare.

ge() [2/2]

ParquetFilter & ge	(	const String &	column,
		Int64	value
	)

Add a greater-than-or-equal condition for an integer column.

Parameters

column	Column name.
value	Integer value to compare.

gt() [1/2]

ParquetFilter & gt	(	const String &	column,
		const String &	value
	)

Add a greater-than condition for a string column.

Parameters

column	Column name.
value	String value to compare.

gt() [2/2]

ParquetFilter & gt	(	const String &	column,
		Int64	value
	)

Add a greater-than condition for an integer column.

Parameters

column	Column name.
value	Integer value to compare.

in() [1/2]

ParquetFilter & in	(	const String &	column,
		const std::vector< Int64 > &	values
	)

Add an IN condition for an integer column.

Parameters

column	Column name.
values	Integer values to compare.

in() [2/2]

ParquetFilter & in	(	const String &	column,
		const std::vector< String > &	values
	)

Add an IN condition for a string column.

Parameters

column	Column name.
values	String values to compare.

le() [1/2]

ParquetFilter & le	(	const String &	column,
		const String &	value
	)

Add a less-than-or-equal condition for a string column.

Parameters

column	Column name.
value	String value to compare.

le() [2/2]

ParquetFilter & le	(	const String &	column,
		Int64	value
	)

Add a less-than-or-equal condition for an integer column.

Parameters

column	Column name.
value	Integer value to compare.

lt() [1/2]

ParquetFilter & lt	(	const String &	column,
		const String &	value
	)

Add a less-than condition for a string column.

Parameters

column	Column name.
value	String value to compare.

lt() [2/2]

ParquetFilter & lt	(	const String &	column,
		Int64	value
	)

Add a less-than condition for an integer column.

Parameters

column	Column name.
value	Integer value to compare.

merge()

static FilterExpression merge ( const FilterExpression &  lhs, const FilterExpression &  rhs, const String &  connector = "AND"  )

static

Merge two filter expressions with a connector.

Parameters

[in]	lhs	Left-hand side filter expression.
[in]	rhs	Right-hand side filter expression.
[in]	connector	Logical connector ("AND" or "OR").

Returns

Combined filter expression.

ne() [1/2]

ParquetFilter & ne	(	const String &	column,
		const String &	value
	)

Add an inequality condition for a string column.

Parameters

column	Column name.
value	String value to compare.

ne() [2/2]

ParquetFilter & ne	(	const String &	column,
		Int64	value
	)

Add an inequality condition for an integer column.

Parameters

column	Column name.
value	Integer value to compare.

orNext()

ParquetFilter & orNext

(

)

Combine the next condition with logical OR.

Member Data Documentation

expr_

FilterExpression expr_

private

next_connector_

String next_connector_ {"AND"}

private