Struct ParquetSourceConfig 

pub struct ParquetSourceConfig {
    pub source: ParquetLocation,
    pub batch_size: usize,
    pub columns: Option<Vec<String>>,
    pub concurrency: usize,
}

Available on crate features source-parquet and source-rest only.

Configuration for the Parquet source connector.

Fields

source: ParquetLocation

Where to read Parquet from — a local file, a local glob pattern, or S3.

batch_size: usize

Arrow RecordBatch size used as the per-page hint when streaming.

Passed verbatim to ParquetRecordBatchStreamBuilder::with_batch_size, which is itself only a hint — Arrow may emit smaller batches at row-group boundaries, so a single emitted faucet_core::StreamPage can hold fewer rows than this number. Larger values improve throughput at the cost of memory.

batch_size = 0 is the “no batching” sentinel: the call to with_batch_size is skipped and the underlying file’s native row-group size drives the page cadence (one page per row-group). Useful for sinks like SQL COPY / BigQuery load jobs that prefer one large request to many small ones.

Defaults to DEFAULT_BATCH_SIZE.

columns: Option<Vec<String>>

Optional column projection (column pruning).

When set, only the named columns are decoded — non-projected columns are skipped entirely at the Parquet level, reducing I/O. Errors out if a name does not exist in the file’s schema.

concurrency: usize

Maximum number of files to read concurrently for Glob / S3 prefix modes. Ignored for single-file modes.

Implementations

impl ParquetSourceConfig

pub fn new(source: ParquetLocation) -> ParquetSourceConfig

Build a config from a ParquetLocation with sensible defaults.

pub fn local(path: impl Into<String>) -> ParquetSourceConfig

Convenience: build a config that reads one local file path.

pub fn glob(pattern: impl Into<String>) -> ParquetSourceConfig

Convenience: build a config that reads files matching a local glob.

pub fn s3(s3: ParquetS3Config) -> ParquetSourceConfig

Convenience: build a config that reads from an S3 location.

pub fn batch_size(self, size: usize) -> ParquetSourceConfig

Override the Arrow RecordBatch size.

Pass 0 to opt out of batching — the underlying file’s native row-group size drives the page cadence instead.

pub fn with_batch_size(self, batch_size: usize) -> ParquetSourceConfig

Set the per-page row-count hint for Source::stream_pages.

Alias for Self::batch_size — provided so the builder reads the same as every other faucet source.

pub fn columns<I, S>(self, columns: I) -> ParquetSourceConfig

where I: IntoIterator<Item = S>, S: Into<String>,

Restrict decoding to the named columns.

pub fn concurrency(self, concurrency: usize) -> ParquetSourceConfig

Override the parallel-file-read concurrency.

Trait Implementations

impl Clone for ParquetSourceConfig

fn clone(&self) -> ParquetSourceConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ParquetSourceConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ParquetSourceConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<ParquetSourceConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ParquetSourceConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for ParquetSourceConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.