NAME
DBIO::DuckDB::Arrow - Read a DuckDB result through libduckdb's Arrow interface
VERSION
version 0.900007
DESCRIPTION
The decoder behind "duckdb_arrow_fetch" in DBIO::DuckDB::Storage; call that method, not this module. It prepares and executes the statement on the DBI handle, converts the result block by block with libduckdb's duckdb_to_arrow_schema and duckdb_data_chunk_to_arrow and decodes the Arrow buffers of each column in one unpack per buffer. DuckDB's type ids decide what Arrow's formats cannot (UHUGEINT against HUGEINT, BIT and BIGNUM against BLOB, TIME WITH TIME ZONE against TIME). Every pointer libduckdb hands out is released on every way out.
METHODS
fetch
my $t = DBIO::DuckDB::Arrow->fetch($dbh, $sql, \@binds, \&mask);
Returns { names, formats, columns, rows } as described at "duckdb_arrow_fetch" in DBIO::DuckDB::Storage; dies with a message naming the column and the Arrow format for a type it cannot render. The optional \&mask is called with the text libduckdb reports for a failed conversion and answers the text to die with; the storage hands in its _mask_error_values. Without it the text is used as it is.
AUTHOR
DBIO Authors
COPYRIGHT AND LICENSE
Copyright (C) 2026 DBIO Authors
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.