parquet 0.0.4 → 0.2.5
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Cargo.lock +48 -40
- data/Gemfile +1 -1
- data/README.md +92 -2
- data/ext/parquet/Cargo.toml +5 -8
- data/ext/parquet/src/enumerator.rs +11 -5
- data/ext/parquet/src/lib.rs +5 -0
- data/ext/parquet/src/reader/mod.rs +42 -0
- data/ext/parquet/src/{reader.rs → reader/parquet_column_reader.rs} +7 -164
- data/ext/parquet/src/reader/parquet_row_reader.rs +152 -0
- data/ext/parquet/src/ruby_reader.rs +2 -3
- data/ext/parquet/src/types/core_types.rs +73 -0
- data/ext/parquet/src/types/mod.rs +30 -0
- data/ext/parquet/src/{types.rs → types/parquet_value.rs} +171 -435
- data/ext/parquet/src/types/record_types.rs +204 -0
- data/ext/parquet/src/types/timestamp.rs +85 -0
- data/ext/parquet/src/types/type_conversion.rs +753 -0
- data/ext/parquet/src/types/writer_types.rs +270 -0
- data/ext/parquet/src/utils.rs +34 -26
- data/ext/parquet/src/writer/mod.rs +403 -0
- data/lib/parquet/version.rb +1 -1
- data/lib/parquet.rbi +33 -2
- metadata +13 -4
@@ -0,0 +1,270 @@
|
|
1
|
+
use std::{
|
2
|
+
io::{self, Write},
|
3
|
+
str::FromStr,
|
4
|
+
sync::Arc,
|
5
|
+
};
|
6
|
+
|
7
|
+
use arrow_array::{Array, RecordBatch};
|
8
|
+
use magnus::{value::ReprValue, Error as MagnusError, RString, Ruby, Symbol, TryConvert, Value};
|
9
|
+
use parquet::{arrow::ArrowWriter, errors::ParquetError};
|
10
|
+
use tempfile::NamedTempFile;
|
11
|
+
|
12
|
+
use crate::types::{ListField, MapField, ParquetSchemaType};
|
13
|
+
|
14
|
+
#[derive(Debug)]
|
15
|
+
pub struct SchemaField {
|
16
|
+
pub name: String,
|
17
|
+
pub type_: ParquetSchemaType,
|
18
|
+
}
|
19
|
+
|
20
|
+
#[derive(Debug)]
|
21
|
+
pub struct ParquetWriteArgs {
|
22
|
+
pub read_from: Value,
|
23
|
+
pub write_to: Value,
|
24
|
+
pub schema: Vec<SchemaField>,
|
25
|
+
pub batch_size: Option<usize>,
|
26
|
+
}
|
27
|
+
|
28
|
+
pub trait SendableWrite: Send + Write {}
|
29
|
+
impl<T: Send + Write> SendableWrite for T {}
|
30
|
+
|
31
|
+
pub struct IoLikeValue(pub(crate) Value);
|
32
|
+
|
33
|
+
impl Write for IoLikeValue {
|
34
|
+
fn write(&mut self, buf: &[u8]) -> Result<usize, io::Error> {
|
35
|
+
let ruby_bytes = RString::from_slice(buf);
|
36
|
+
|
37
|
+
let bytes_written = self
|
38
|
+
.0
|
39
|
+
.funcall::<_, _, usize>("write", (ruby_bytes,))
|
40
|
+
.map_err(|e| io::Error::new(io::ErrorKind::Other, e.to_string()))?;
|
41
|
+
|
42
|
+
Ok(bytes_written)
|
43
|
+
}
|
44
|
+
|
45
|
+
fn flush(&mut self) -> Result<(), io::Error> {
|
46
|
+
self.0
|
47
|
+
.funcall::<_, _, Value>("flush", ())
|
48
|
+
.map_err(|e| io::Error::new(io::ErrorKind::Other, e.to_string()))?;
|
49
|
+
|
50
|
+
Ok(())
|
51
|
+
}
|
52
|
+
}
|
53
|
+
|
54
|
+
impl FromStr for ParquetSchemaType {
|
55
|
+
type Err = MagnusError;
|
56
|
+
|
57
|
+
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
58
|
+
match s {
|
59
|
+
"int8" => Ok(ParquetSchemaType::Int8),
|
60
|
+
"int16" => Ok(ParquetSchemaType::Int16),
|
61
|
+
"int32" => Ok(ParquetSchemaType::Int32),
|
62
|
+
"int64" => Ok(ParquetSchemaType::Int64),
|
63
|
+
"uint8" => Ok(ParquetSchemaType::UInt8),
|
64
|
+
"uint16" => Ok(ParquetSchemaType::UInt16),
|
65
|
+
"uint32" => Ok(ParquetSchemaType::UInt32),
|
66
|
+
"uint64" => Ok(ParquetSchemaType::UInt64),
|
67
|
+
"float" | "float32" => Ok(ParquetSchemaType::Float),
|
68
|
+
"double" | "float64" => Ok(ParquetSchemaType::Double),
|
69
|
+
"string" | "utf8" => Ok(ParquetSchemaType::String),
|
70
|
+
"binary" => Ok(ParquetSchemaType::Binary),
|
71
|
+
"boolean" | "bool" => Ok(ParquetSchemaType::Boolean),
|
72
|
+
"date32" => Ok(ParquetSchemaType::Date32),
|
73
|
+
"timestamp_millis" => Ok(ParquetSchemaType::TimestampMillis),
|
74
|
+
"timestamp_micros" => Ok(ParquetSchemaType::TimestampMicros),
|
75
|
+
"list" => Ok(ParquetSchemaType::List(Box::new(ListField {
|
76
|
+
item_type: ParquetSchemaType::Int8,
|
77
|
+
}))),
|
78
|
+
"map" => Ok(ParquetSchemaType::Map(Box::new(MapField {
|
79
|
+
key_type: ParquetSchemaType::String,
|
80
|
+
value_type: ParquetSchemaType::Int8,
|
81
|
+
}))),
|
82
|
+
_ => Err(MagnusError::new(
|
83
|
+
magnus::exception::runtime_error(),
|
84
|
+
format!("Invalid schema type: {}", s),
|
85
|
+
)),
|
86
|
+
}
|
87
|
+
}
|
88
|
+
}
|
89
|
+
|
90
|
+
impl TryConvert for ParquetSchemaType {
|
91
|
+
fn try_convert(value: Value) -> Result<Self, MagnusError> {
|
92
|
+
let ruby = unsafe { Ruby::get_unchecked() };
|
93
|
+
let schema_type = parse_string_or_symbol(&ruby, value)?;
|
94
|
+
|
95
|
+
schema_type.unwrap().parse()
|
96
|
+
}
|
97
|
+
}
|
98
|
+
|
99
|
+
// We know this type is safe to move between threads because it's just an enum
|
100
|
+
// with simple primitive types and strings
|
101
|
+
unsafe impl Send for ParquetSchemaType {}
|
102
|
+
|
103
|
+
fn parse_string_or_symbol(ruby: &Ruby, value: Value) -> Result<Option<String>, MagnusError> {
|
104
|
+
if value.is_nil() {
|
105
|
+
Ok(None)
|
106
|
+
} else if value.is_kind_of(ruby.class_string()) {
|
107
|
+
RString::from_value(value)
|
108
|
+
.ok_or_else(|| {
|
109
|
+
MagnusError::new(magnus::exception::type_error(), "Invalid string value")
|
110
|
+
})?
|
111
|
+
.to_string()
|
112
|
+
.map(|s| Some(s))
|
113
|
+
} else if value.is_kind_of(ruby.class_symbol()) {
|
114
|
+
Symbol::from_value(value)
|
115
|
+
.ok_or_else(|| {
|
116
|
+
MagnusError::new(magnus::exception::type_error(), "Invalid symbol value")
|
117
|
+
})?
|
118
|
+
.funcall("to_s", ())
|
119
|
+
.map(|s| Some(s))
|
120
|
+
} else {
|
121
|
+
Err(MagnusError::new(
|
122
|
+
magnus::exception::type_error(),
|
123
|
+
"Value must be a String or Symbol",
|
124
|
+
))
|
125
|
+
}
|
126
|
+
}
|
127
|
+
|
128
|
+
pub enum WriterOutput {
|
129
|
+
File(ArrowWriter<Box<dyn SendableWrite>>),
|
130
|
+
TempFile(ArrowWriter<Box<dyn SendableWrite>>, NamedTempFile),
|
131
|
+
}
|
132
|
+
|
133
|
+
impl WriterOutput {
|
134
|
+
pub fn write(&mut self, batch: &RecordBatch) -> Result<(), ParquetError> {
|
135
|
+
match self {
|
136
|
+
WriterOutput::File(writer) | WriterOutput::TempFile(writer, _) => writer.write(batch),
|
137
|
+
}
|
138
|
+
}
|
139
|
+
|
140
|
+
pub fn close(self) -> Result<Option<NamedTempFile>, ParquetError> {
|
141
|
+
match self {
|
142
|
+
WriterOutput::File(writer) => {
|
143
|
+
writer.close()?;
|
144
|
+
Ok(None)
|
145
|
+
}
|
146
|
+
WriterOutput::TempFile(writer, temp_file) => {
|
147
|
+
writer.close()?;
|
148
|
+
Ok(Some(temp_file))
|
149
|
+
}
|
150
|
+
}
|
151
|
+
}
|
152
|
+
}
|
153
|
+
|
154
|
+
pub struct ParquetErrorWrapper(pub ParquetError);
|
155
|
+
|
156
|
+
impl From<ParquetErrorWrapper> for MagnusError {
|
157
|
+
fn from(err: ParquetErrorWrapper) -> Self {
|
158
|
+
MagnusError::new(
|
159
|
+
magnus::exception::runtime_error(),
|
160
|
+
format!("Parquet error: {}", err.0),
|
161
|
+
)
|
162
|
+
}
|
163
|
+
}
|
164
|
+
|
165
|
+
pub struct ColumnCollector {
|
166
|
+
pub name: String,
|
167
|
+
pub type_: ParquetSchemaType,
|
168
|
+
pub values: Vec<crate::types::ParquetValue>,
|
169
|
+
}
|
170
|
+
|
171
|
+
impl ColumnCollector {
|
172
|
+
pub fn new(name: String, type_: ParquetSchemaType) -> Self {
|
173
|
+
Self {
|
174
|
+
name,
|
175
|
+
type_,
|
176
|
+
values: Vec::new(),
|
177
|
+
}
|
178
|
+
}
|
179
|
+
|
180
|
+
pub fn push_value(&mut self, value: Value) -> Result<(), MagnusError> {
|
181
|
+
use crate::types::ParquetValue;
|
182
|
+
use crate::{
|
183
|
+
convert_to_binary, convert_to_boolean, convert_to_date32, convert_to_list,
|
184
|
+
convert_to_map, convert_to_timestamp_micros, convert_to_timestamp_millis,
|
185
|
+
NumericConverter,
|
186
|
+
};
|
187
|
+
|
188
|
+
let parquet_value = match &self.type_ {
|
189
|
+
ParquetSchemaType::Int8 => {
|
190
|
+
let v = NumericConverter::<i8>::convert_with_string_fallback(value)?;
|
191
|
+
ParquetValue::Int8(v)
|
192
|
+
}
|
193
|
+
ParquetSchemaType::Int16 => {
|
194
|
+
let v = NumericConverter::<i16>::convert_with_string_fallback(value)?;
|
195
|
+
ParquetValue::Int16(v)
|
196
|
+
}
|
197
|
+
ParquetSchemaType::Int32 => {
|
198
|
+
let v = NumericConverter::<i32>::convert_with_string_fallback(value)?;
|
199
|
+
ParquetValue::Int32(v)
|
200
|
+
}
|
201
|
+
ParquetSchemaType::Int64 => {
|
202
|
+
let v = NumericConverter::<i64>::convert_with_string_fallback(value)?;
|
203
|
+
ParquetValue::Int64(v)
|
204
|
+
}
|
205
|
+
ParquetSchemaType::UInt8 => {
|
206
|
+
let v = NumericConverter::<u8>::convert_with_string_fallback(value)?;
|
207
|
+
ParquetValue::UInt8(v)
|
208
|
+
}
|
209
|
+
ParquetSchemaType::UInt16 => {
|
210
|
+
let v = NumericConverter::<u16>::convert_with_string_fallback(value)?;
|
211
|
+
ParquetValue::UInt16(v)
|
212
|
+
}
|
213
|
+
ParquetSchemaType::UInt32 => {
|
214
|
+
let v = NumericConverter::<u32>::convert_with_string_fallback(value)?;
|
215
|
+
ParquetValue::UInt32(v)
|
216
|
+
}
|
217
|
+
ParquetSchemaType::UInt64 => {
|
218
|
+
let v = NumericConverter::<u64>::convert_with_string_fallback(value)?;
|
219
|
+
ParquetValue::UInt64(v)
|
220
|
+
}
|
221
|
+
ParquetSchemaType::Float => {
|
222
|
+
let v = NumericConverter::<f32>::convert_with_string_fallback(value)?;
|
223
|
+
ParquetValue::Float32(v)
|
224
|
+
}
|
225
|
+
ParquetSchemaType::Double => {
|
226
|
+
let v = NumericConverter::<f64>::convert_with_string_fallback(value)?;
|
227
|
+
ParquetValue::Float64(v)
|
228
|
+
}
|
229
|
+
ParquetSchemaType::String => {
|
230
|
+
let v = String::try_convert(value)?;
|
231
|
+
ParquetValue::String(v)
|
232
|
+
}
|
233
|
+
ParquetSchemaType::Binary => {
|
234
|
+
let v = convert_to_binary(value)?;
|
235
|
+
ParquetValue::Bytes(v)
|
236
|
+
}
|
237
|
+
ParquetSchemaType::Boolean => {
|
238
|
+
let v = convert_to_boolean(value)?;
|
239
|
+
ParquetValue::Boolean(v)
|
240
|
+
}
|
241
|
+
ParquetSchemaType::Date32 => {
|
242
|
+
let v = convert_to_date32(value)?;
|
243
|
+
ParquetValue::Date32(v)
|
244
|
+
}
|
245
|
+
ParquetSchemaType::TimestampMillis => {
|
246
|
+
let v = convert_to_timestamp_millis(value)?;
|
247
|
+
ParquetValue::TimestampMillis(v, None)
|
248
|
+
}
|
249
|
+
ParquetSchemaType::TimestampMicros => {
|
250
|
+
let v = convert_to_timestamp_micros(value)?;
|
251
|
+
ParquetValue::TimestampMicros(v, None)
|
252
|
+
}
|
253
|
+
ParquetSchemaType::List(list_field) => {
|
254
|
+
let values = convert_to_list(value, list_field)?;
|
255
|
+
ParquetValue::List(values)
|
256
|
+
}
|
257
|
+
ParquetSchemaType::Map(map_field) => {
|
258
|
+
let map = convert_to_map(value, map_field)?;
|
259
|
+
ParquetValue::Map(map)
|
260
|
+
}
|
261
|
+
};
|
262
|
+
self.values.push(parquet_value);
|
263
|
+
Ok(())
|
264
|
+
}
|
265
|
+
|
266
|
+
pub fn take_array(&mut self) -> Result<Arc<dyn Array>, MagnusError> {
|
267
|
+
let values = std::mem::take(&mut self.values);
|
268
|
+
crate::convert_parquet_values_to_arrow(values, &self.type_)
|
269
|
+
}
|
270
|
+
}
|
data/ext/parquet/src/utils.rs
CHANGED
@@ -4,6 +4,8 @@ use magnus::{
|
|
4
4
|
Error, RString, Ruby, Symbol, Value,
|
5
5
|
};
|
6
6
|
|
7
|
+
use crate::ParserResultType;
|
8
|
+
|
7
9
|
fn parse_string_or_symbol(ruby: &Ruby, value: Value) -> Result<Option<String>, Error> {
|
8
10
|
if value.is_nil() {
|
9
11
|
Ok(None)
|
@@ -28,7 +30,7 @@ fn parse_string_or_symbol(ruby: &Ruby, value: Value) -> Result<Option<String>, E
|
|
28
30
|
#[derive(Debug)]
|
29
31
|
pub struct ParquetRowsArgs {
|
30
32
|
pub to_read: Value,
|
31
|
-
pub result_type:
|
33
|
+
pub result_type: ParserResultType,
|
32
34
|
pub columns: Option<Vec<String>>,
|
33
35
|
}
|
34
36
|
|
@@ -43,28 +45,31 @@ pub fn parse_parquet_rows_args(ruby: &Ruby, args: &[Value]) -> Result<ParquetRow
|
|
43
45
|
&["result_type", "columns"],
|
44
46
|
)?;
|
45
47
|
|
46
|
-
let result_type = match kwargs
|
48
|
+
let result_type: ParserResultType = match kwargs
|
47
49
|
.optional
|
48
50
|
.0
|
49
51
|
.map(|value| parse_string_or_symbol(ruby, value))
|
50
52
|
{
|
51
|
-
Some(Ok(Some(parsed))) =>
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
53
|
+
Some(Ok(Some(parsed))) => parsed.try_into().map_err(|e| {
|
54
|
+
Error::new(
|
55
|
+
magnus::exception::runtime_error(),
|
56
|
+
format!(
|
57
|
+
"Invalid result type: {e}. Must be one of {}",
|
58
|
+
ParserResultType::iter()
|
59
|
+
.map(|v| v.to_string())
|
60
|
+
.collect::<Vec<_>>()
|
61
|
+
.join(", ")
|
62
|
+
),
|
63
|
+
)
|
64
|
+
})?,
|
65
|
+
Some(Ok(None)) => ParserResultType::Hash,
|
61
66
|
Some(Err(_)) => {
|
62
67
|
return Err(Error::new(
|
63
68
|
magnus::exception::type_error(),
|
64
69
|
"result_type must be a String or Symbol",
|
65
70
|
))
|
66
71
|
}
|
67
|
-
None =>
|
72
|
+
None => ParserResultType::Hash,
|
68
73
|
};
|
69
74
|
|
70
75
|
Ok(ParquetRowsArgs {
|
@@ -77,7 +82,7 @@ pub fn parse_parquet_rows_args(ruby: &Ruby, args: &[Value]) -> Result<ParquetRow
|
|
77
82
|
#[derive(Debug)]
|
78
83
|
pub struct ParquetColumnsArgs {
|
79
84
|
pub to_read: Value,
|
80
|
-
pub result_type:
|
85
|
+
pub result_type: ParserResultType,
|
81
86
|
pub columns: Option<Vec<String>>,
|
82
87
|
pub batch_size: Option<usize>,
|
83
88
|
}
|
@@ -96,28 +101,31 @@ pub fn parse_parquet_columns_args(
|
|
96
101
|
&["result_type", "columns", "batch_size"],
|
97
102
|
)?;
|
98
103
|
|
99
|
-
let result_type = match kwargs
|
104
|
+
let result_type: ParserResultType = match kwargs
|
100
105
|
.optional
|
101
106
|
.0
|
102
107
|
.map(|value| parse_string_or_symbol(ruby, value))
|
103
108
|
{
|
104
|
-
Some(Ok(Some(parsed))) =>
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
109
|
+
Some(Ok(Some(parsed))) => parsed.try_into().map_err(|e| {
|
110
|
+
Error::new(
|
111
|
+
magnus::exception::runtime_error(),
|
112
|
+
format!(
|
113
|
+
"Invalid result type: {e}. Must be one of {}",
|
114
|
+
ParserResultType::iter()
|
115
|
+
.map(|v| v.to_string())
|
116
|
+
.collect::<Vec<_>>()
|
117
|
+
.join(", ")
|
118
|
+
),
|
119
|
+
)
|
120
|
+
})?,
|
121
|
+
Some(Ok(None)) => ParserResultType::Hash,
|
114
122
|
Some(Err(_)) => {
|
115
123
|
return Err(Error::new(
|
116
124
|
magnus::exception::type_error(),
|
117
125
|
"result_type must be a String or Symbol",
|
118
126
|
))
|
119
127
|
}
|
120
|
-
None =>
|
128
|
+
None => ParserResultType::Hash,
|
121
129
|
};
|
122
130
|
|
123
131
|
Ok(ParquetColumnsArgs {
|