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.