JavaScript & React libraryAPI

Class: DuckDBInstance

The DuckDBInstance class manages a DuckDB database instance, providing methods to interact with the database such as executing queries, uploading files, and managing tables.

Param

The DuckDB instance.

Param

The connection to the DuckDB instance.

Accessors

connection

Get Signature

get connection(): AsyncDuckDBConnection

Returns

AsyncDuckDBConnection


db

Get Signature

get db(): AsyncDuckDB

Returns

AsyncDuckDB

Methods

getInstance()

static getInstance(): Promise<DuckDBInstance>

Returns

Promise<DuckDBInstance>


destroy()

destroy(): Promise<void>

Returns

Promise<void>


dropTable()

dropTable(tableName): Promise<void>

Parameters

ParameterType
tableNamestring

Returns

Promise<void>


query()

query(query): Promise<undefined | Table<any>>

Parameters

ParameterType
querystring

Returns

Promise<undefined | Table<any>>


exec()

exec(query): Promise<void>

Parameters

ParameterType
querystring

Returns

Promise<void>


send()

send(query, callback): Promise<void>

Parameters

ParameterType
querystring
callback(result) => void

Returns

Promise<void>


uploadData()

uploadData(data, tableName, insert, csvParseTimeFormat?, csvColumns?): Promise<{ error?: unknown; }>

Parameters

ParameterTypeDefault value
datastring | Table<any> | Record<string, unknown>[] | ArrayBuffer | Uint8Array<ArrayBufferLike> | Fileundefined
tableNamestringundefined
insertbooleanfalse
csvParseTimeFormat?stringundefined
csvColumns?Record<string, string>undefined

Returns

Promise<{ error?: unknown; }>


uploadArrow()

uploadArrow(table, tableName): Promise<{ error?: unknown; }>

Parameters

ParameterType
tableTable<any> | ArrayBuffer | Uint8Array<ArrayBufferLike>
tableNamestring

Returns

Promise<{ error?: unknown; }>


exportTableToArrow()

exportTableToArrow(tableName): Promise<undefined | Table<any>>

Parameters

ParameterType
tableNamestring

Returns

Promise<undefined | Table<any>>


exportTableToArrowBuffer()

exportTableToArrowBuffer(tableName): Promise<undefined | Uint8Array<ArrayBufferLike>>

Parameters

ParameterType
tableNamestring

Returns

Promise<undefined | Uint8Array<ArrayBufferLike>>


exportTableToPq()

exportTableToPq(tableName): Promise<undefined | Uint8Array<ArrayBufferLike>>

Parameters

ParameterType
tableNamestring

Returns

Promise<undefined | Uint8Array<ArrayBufferLike>>


exportTableToCSV()

exportTableToCSV(tableName): Promise<undefined | Uint8Array<ArrayBufferLike>>

Parameters

ParameterType
tableNamestring

Returns

Promise<undefined | Uint8Array<ArrayBufferLike>>


uploadObject()

uploadObject(data, tableName, insert): Promise<{ error?: unknown; }>

Parameters

ParameterTypeDefault value
dataRecord<string, unknown>[]undefined
tableNamestringundefined
insertbooleanfalse

Returns

Promise<{ error?: unknown; }>


logTable()

logTable(tableName, full): Promise<void>

Parameters

ParameterTypeDefault value
tableNamestringundefined
fullbooleanfalse

Returns

Promise<void>