serializeDataFrame: Serializes the specified data.frame object to a vector of raw...

Description Usage Arguments Details Value See Also Examples

View source: R/write.R

Description

The R data.frame is serialized as a Raven DataFrame. The concrete column types to use for each individual data.frame column can be specified by the 'types' argument.

Usage

1
serializeDataFrame(df, types = NULL, compress = FALSE, as.nullable = FALSE)

Arguments

df

The data.frame object to serialize

types

The type names for all column types. Must be a vector of character values. May be NULL

compress

A logical indicating whether to compress the content of the returned raw vector

as.nullable

A logical indicating whether the data.frame should be serialized as a NullableDataFrame, even if it contains no NA values

Details

The column types of the R data.frame object are mapped to the corresponding Raven DataFrame column types. The following types exist:

Type name Description
byte int8
short int16
int int32
long int64
float float32
double float64
string UTF-8 encoded unicode string
char single printable ASCII character
boolean logical value TRUE or FALSE
binary arbitrary length byte array

By default, if the 'types' argument is not explicitly specified, all values are mapped to the corresponding largest possible type in order to avoid possible loss of information. However, users can specify the concrete type for each column in the DataFrame file to be written. This is done by providing a vector of character values denoting the type name of each corresponding data.frame column. The index of each entry corresponds to the index of the column in the underlying data.frame to persist.

If the specified data.frame object contains at least one NA value, then the serialized DataFrame will represent a NullableDataFrame. If the data.frame contains no NA values, then the serialized DataFrame will represent a DefaultDataFrame, unless the 'as.nullable' argument is set to TRUE.

The logical 'compress' argument specifies whether the serialized DataFrame is compressed.

Value

A raw vector representing the serialized date.frame object

See Also

writeDataFrame() for directly persisting data.frame objects to the file system

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
## Not run: 
# get a data.frame
df <- cars
# serialize the data.frame to a raw vector
vec <- serializeDataFrame(df)

# specify the concrete types of all columns
coltypes <- c("float", "double")
# serialize the data.frame to a raw vector with concrete types
serializeDataFrame(df, types = coltypes)

## End(Not run)

raven.rdf documentation built on March 17, 2021, 5:07 p.m.