Official Julia implementation of Apache Arrow

Clone this repo:
  1. 36f8958 enable incremental reads of arrow-formatted files (#408) by Ben Baumgold · 3 days ago main
  2. 9385a91 Add Tables.partitions definition for Arrow.Table (#443) by Jacob Quinn · 4 days ago
  3. 94f7e37 Get dictionaries of children only when field.children not nothing (#382) by Önder Kartal · 4 days ago
  4. ebf9fcf Remove scopedenum for EnumX (#444) by Jacob Quinn · 4 days ago
  5. 3008e7f Handle len of -1 in "compressed" buffers from other languages (#442) by Jacob Quinn · 6 days ago

Arrow

docs CI codecov

deps version pkgeval

This is a pure Julia implementation of the Apache Arrow data standard. This package provides Julia AbstractVector objects for referencing data that conforms to the Arrow standard. This allows users to seamlessly interface Arrow formatted data with a great deal of existing Julia code.

Please see this document for a description of the Arrow memory layout.

Installation

The package can be installed by typing in the following in a Julia REPL:

julia> using Pkg; Pkg.add("Arrow")

or to use the official-apache code that follows the official apache release process, you can do:

julia> using Pkg; Pkg.add(url="https://github.com/apache/arrow", subdir="julia/Arrow.jl")

Local Development

When developing on Arrow.jl it is recommended that you run the following to ensure that any changes to ArrowTypes.jl are immediately available to Arrow.jl without requiring a release:

julia --project -e 'using Pkg; Pkg.develop(path="src/ArrowTypes")'

Format Support

This implementation supports the 1.0 version of the specification, including support for:

  • All primitive data types
  • All nested data types
  • Dictionary encodings and messages
  • Extension types
  • Streaming, file, record batch, and replacement and isdelta dictionary messages

It currently doesn't include support for:

  • Tensors or sparse tensors
  • Flight RPC
  • C data interface

Third-party data formats:

See the full documentation for details on reading and writing arrow data.