quackdb_internal::ffi

Function duckdb_query

Source
pub unsafe extern "C" fn duckdb_query(
    connection: *mut _duckdb_connection,
    query: *const i8,
    out_result: *mut duckdb_result,
) -> u32
Expand description

Executes a SQL query within a connection and stores the full (materialized) result in the out_result pointer. If the query fails to execute, DuckDBError is returned and the error message can be retrieved by calling duckdb_result_error.

Note that after running duckdb_query, duckdb_destroy_result must be called on the result object even if the query fails, otherwise the error stored within the result will not be freed correctly.

connection: The connection to perform the query in. query: The SQL query to run. out_result: The query result. returns: DuckDBSuccess on success or DuckDBError on failure.