Skip to content

Pre-release documentation

This describes Beacon 2.0.0-rc3, a release candidate. Behavior documented here may still change before 2.0.0 ships, and some of it is not in any released build yet. For the current stable release, see the 1.8.0 documentation.

Arrow IPC

Read the files

text
read_arrow(glob_paths)

Beacon reads Arrow IPC stream files (.arrow, .feather).

sql
SELECT * FROM read_arrow('streams/*.arrow')

Inspect the schema

Check the columns and the types before you write a query:

sql
SELECT * FROM read_arrow('cruises/*.arrow') LIMIT 0;

Inspect a schema compares the _schema functions, SUMMARIZE, DESCRIBE and LIMIT 0, and says what each one costs.

Format details

Beacon fully supports this format. It reads an Arrow IPC stream file (.arrow, .feather) directly with zero-copy column access.

As an external table

sql
CREATE EXTERNAL TABLE cruise_data
STORED AS ARROW
LOCATION 'cruises/'

See Create External Tables for the full DDL. See Data Sources for the full read model.

Released under the AGPL-3.0 License.