Struct polars_io::json::ArrowJsonReader

pub struct ArrowJsonReader<R> where
    R: Read,  { /* fields omitted */ }

This is supported on crate feature json only.

JSON Reader

This JSON reader allows JSON line-delimited files to be read into the Arrow memory model. Records are loaded in batches and are then converted from row-based data to columnar data.

Example:

use std::sync::Arc;
use arrow2::datatypes::{DataType, Field, Schema};
use arrow2::io::json;
use std::io::{Cursor, BufReader};

let schema = Arc::new(Schema::new(vec![
    Field::new("a", DataType::Int64, true),
    Field::new("b", DataType::Float32, true),
    Field::new("c", DataType::Boolean, true),
    Field::new("d", DataType::Utf8, true),
]));

let data = r#"{"a":1, "b":2.0, "c":false, "d":"4"}
{"a":-10, "b":-3.5, "c":true, "d":null}
{"a":100000000, "b":0.6, "d":"text"}"#;
let mut reader = BufReader::new(Cursor::new(data));
let mut reader = json::Reader::new(&mut reader, schema, 1024, None);
let batch = reader.next().unwrap().unwrap();

Implementations

impl<R> Reader<R> where
    R: Read, 

pub fn new(
    reader: R,
    schema: Arc<Schema>,
    batch_size: usize,
    projection: Option<Vec<String, Global>>
) -> Reader<R>

Create a new JSON Reader from any value that implements the Read trait.

If reading a File, you can customise the Reader, such as to enable schema inference, use ReaderBuilder.

pub fn from_buf_reader(
    reader: BufReader<R>,
    schema: Arc<Schema>,
    batch_size: usize,
    projection: Option<Vec<String, Global>>
) -> Reader<R>

Create a new JSON Reader from a BufReader<R: Read>

To customize the schema, such as to enable schema inference, use ReaderBuilder

pub fn schema(&self) -> &Arc<Schema>

Returns the schema of the reader, useful for getting the schema without reading record batches

pub fn next(&mut self) -> Result<Option<RecordBatch>, ArrowError>

Read the next batch of records

Trait Implementations

impl<R: Read> ArrowReader for ArrowJsonReader<R>

fn next_record_batch(&mut self) -> ArrowResult<Option<RecordBatch>>

fn schema(&self) -> Arc<Schema>

impl<R> Debug for Reader<R> where
    R: Debug + Read, 

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

Formats the value using the given formatter.