Serialize the logical plan of this LazyFrame

Description

Usage

<LazyFrame>$serialize(..., format = c("binary", "json"))

pl__deserialize_lf(data)

Arguments

… These dots are for future extensions and must be empty.

format

A character of the format in which to serialize. One of:

“binary” (default): Serialize to binary format (raw vector).
“json”: Serialize to JSON format (character vector).

data A raw vector of serialized LazyFrame.

Value

\$serialize() returns raw or character, depending on the format argument.
pl$deserialize_lf() returns a deserialized LazyFrame.

Examples

library("polars")

lf <- pl$LazyFrame(a = 1:3)$sum()

# Serialize the logical plan to a binary representation.
serialized <- lf$serialize()
serialized

#>   [1] 44 53 4c 5f 56 45 52 53 49 4f 4e 18 00 00 00 39 63 31 34 37 36 32 36 37 37
#>  [26] 61 35 64 37 64 64 33 66 64 65 38 31 34 38 63 38 39 36 38 64 34 62 65 63 31
#>  [51] 63 64 61 64 61 31 63 35 31 39 62 34 65 39 36 66 36 62 32 31 66 64 31 37 38
#>  [76] 65 31 33 62 83 a4 72 6f 6f 74 82 a3 69 64 78 02 a7 76 65 72 73 69 6f 6e 01
#> [101] aa 64 61 74 61 66 72 61 6d 65 73 92 82 a5 76 61 6c 75 65 c0 a7 76 65 72 73
#> [126] 69 6f 6e 00 82 a5 76 61 6c 75 65 91 dc 01 90 cc ff cc ff cc ff cc ff cc b8
#> [151] 00 00 00 04 00 00 00 cc f2 cc ff cc ff cc ff 14 00 00 00 04 00 01 00 00 00
#> [176] 0a 00 0b 00 08 00 0a 00 04 00 cc f2 cc ff cc ff cc ff 48 00 00 00 10 00 00
#> [201] 00 00 00 0a 00 0c 00 00 00 04 00 08 00 01 00 00 00 04 00 00 00 cc f4 cc ff
#> [226] cc ff cc ff 18 00 00 00 0c 00 00 00 08 00 0c 00 04 00 08 00 03 00 00 00 5b
#> [251] 30 5d 00 09 00 00 00 5f 50 4c 5f 46 4c 41 47 53 00 00 00 01 00 00 00 04 00
#> [276] 00 00 cc ec cc ff cc ff cc ff 38 00 00 00 20 00 00 00 18 00 00 00 01 02 00
#> [301] 00 10 00 12 00 04 00 10 00 11 00 08 00 00 00 0c 00 00 00 00 00 cc f4 cc ff
#> [326] cc ff cc ff 20 00 00 00 01 00 00 00 08 00 09 00 04 00 08 00 01 00 00 00 61
#> [351] 00 00 00 00 00 00 00 cc ff cc ff cc ff cc ff cc 80 00 00 00 04 00 00 00 cc
#> [376] ec cc ff cc ff cc ff 40 00 00 00 00 00 00 00 14 00 00 00 04 00 03 00 0c 00
#> [401] 13 00 10 00 12 00 0c 00 04 00 cc ea cc ff cc ff cc ff 03 00 00 00 00 00 00
#> [426] 00 3c 00 00 00 10 00 00 00 00 00 0a 00 14 00 04 00 0c 00 10 00 02 00 00 00
#> [451] 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0c
#> [476] 00 00 00 00 00 00 00 00 00 00 00 01 00 00 00 03 00 00 00 00 00 00 00 00 00
#> [501] 00 00 00 00 00 00 01 00 00 00 02 00 00 00 03 00 00 00 00 00 00 00 00 00 00
#> [526] 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
#> [551] 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 cc ff cc ff cc
#> [576] ff cc ff 00 00 00 00 a7 76 65 72 73 69 6f 6e 01 a9 64 73 6c 5f 70 6c 61 6e
#> [601] 73 93 82 a5 76 61 6c 75 65 c0 a7 76 65 72 73 69 6f 6e 00 82 a5 76 61 6c 75
#> [626] 65 81 ad 44 61 74 61 46 72 61 6d 65 53 63 61 6e 82 a2 64 66 82 a3 69 64 78
#> [651] 01 a7 76 65 72 73 69 6f 6e 01 a6 73 63 68 65 6d 61 81 a6 66 69 65 6c 64 73
#> [676] 81 a1 61 a5 49 6e 74 33 32 a7 76 65 72 73 69 6f 6e 01 82 a5 76 61 6c 75 65
#> [701] 81 ab 4d 61 70 46 75 6e 63 74 69 6f 6e 82 a5 69 6e 70 75 74 82 a3 69 64 78
#> [726] 01 a7 76 65 72 73 69 6f 6e 01 a8 66 75 6e 63 74 69 6f 6e 81 a5 53 74 61 74
#> [751] 73 a3 53 75 6d a7 76 65 72 73 69 6f 6e 01

# The bytes can later be deserialized back into a LazyFrame.
pl$deserialize_lf(serialized)$collect()

#> shape: (1, 1)
#> ┌─────┐
#> │ a   │
#> │ --- │
#> │ i32 │
#> ╞═════╡
#> │ 6   │
#> └─────┘