rduckhts_load: Load DuckHTS Extension

In Rduckhts: 'DuckDB' High Throughput Sequencing File Formats Reader Extension

Load DuckHTS Extension

Description

Loads the DuckHTS extension into an existing DuckDB connection. This must be called before using HTS reader functions on a connection not created by rduckhts_connect().

Usage

rduckhts_load(con, extension_path = NULL)

Arguments

con	A DuckDB connection object.
extension_path	Optional path to the DuckHTS extension file. If NULL, uses the extension bundled with Rduckhts.

Details

DuckDB 1.5.0 or newer is required. SQL registration errors retain the underlying DuckDB diagnostic in the initialization error.

The connection must permit unsigned extension loading. With current versions of the duckdb R package, its driver must also permit extension loading. Prefer rduckhts_connect() when Rduckhts owns the connection. File-backed connections receive TEMP macros on this connection after LOAD. Use rduckhts_install_macros() on additional connections.

Value

TRUE if the extension was loaded successfully.

Examples

con <- rduckhts_connect()
DBI::dbDisconnect(con, shutdown = TRUE)

Rduckhts documentation built on Oct. 25, 2026, 1:08 a.m.