Overview

Module educkdb

• Description
• Data Types
• Function Index
• Function Details

Copyright © 2022-2023 Maas-Maarten Zeeman

Authors: Maas-Maarten Zeeman (mmzeeman@xs4all.nl).

Description

Data Types

append_response()

append_response() = ok | {error, term()}

appender()

appender() = reference()

bind_response()

bind_response() = ok | {error, term()}

column()

column() = #{data := [data()], type := type_name()}

connection()

connection() = reference()

data()

data() = boolean() | int8() | int16() | int32() | int64() | uint8() | uint16() | uint32() | uint64() | float() | hugeint() | calendar:date() | time() | datetime() | binary() | [data()] | #{binary() => data()} | {map, [data()], [data()]}

data_chunk()

data_chunk() = reference()

database()

database() = reference()

datetime()

datetime() = {calendar:date(), time()}

hugeint()

hugeint() = #hugeint{upper = educkdb:int64(), lower = educkdb:uint64()}

struct, making up a 128 bit signed integer.

idx()

idx() = uint64()

DuckDB index type

int16()

int16() = -32767..32767

DuckDB shortint

int32()

int32() = -2147483647..2147483647

DuckDB integer

int64()

int64() = -9223372036854775807..9223372036854775807

DuckDB bigint

int8()

int8() = -127..127

DuckDB tinyint

named_column()

named_column() = #{name := binary(), data := [data()], type := type_name()}

prepared_statement()

prepared_statement() = reference()

result()

result() = reference()

second()

second() = float()

In the range 0.0..60.0

sql()

sql() = iodata()

time()

time() = {calendar:hour(), calendar:minute(), second()}

type_name()

type_name() = boolean | tinyint | smallint | integer | bigint | utinyint | usmallint | uinteger | ubigint | float | double | hugeint | timestamp | date | time | interval | varchar | blob | decimal | timestamp_s | timestamp_ms | timestamp_ns | enum | list | struct | map | uuid | json

Note: decimal, timestamp_s, timestamp_ms, timestamp_ns and interval's are not supported yet.

uint16()

uint16() = 0..65535

DuckDB ushortint

uint32()

uint32() = 0..4294967295

DuckDB uinteger

uint64()

uint64() = 0..18446744073709551615

DuckDB ubigint

uint8()

uint8() = 0..255

DuckDB duckdb utinyint

Function Index

Function Details

open/1

Open, or create a duckdb database with default options.

open/2

Open, or create a duckdb file

connect/1

Connect to the database. In the background a thread is started which is used by long running commands. Note: It is adviced to use the connection in a single process.

disconnect/1

Disconnect from the database. Stops the thread. The calling pid will receive: {disconnect, Ref, ok | {error, _}}.

close/1

Close the database. All open connections will become unusable.

config_flag_info/0

Return a map with config flags, and explanations. The options can vary depending on the underlying DuckDB version used. For more information about DuckDB configuration options, see: DuckDB Configuration.

query/2

Query the database. The answer the answer is returned immediately.

prepare/2

Compile, and prepare a statement for later execution.

execute_prepared/1

Execute a prepared statement. The answer is returned.

bind_boolean/3

Bind a boolean to the prepared statement at the specified index.

bind_int8/3

Bind an int8 to the prepared statement at the specified index.

bind_int16/3

Bind an int16 to the prepared statement at the specified index.

bind_int32/3

Bind an int32 to the prepared statement at the specified index.

bind_int64/3

Bind an int64 to the prepared statement at the specified index.

bind_uint8/3

Bind an uint8 to the prepared statement at the specified index.

bind_uint16/3

Bind an uint8 to the prepared statement at the specified index.

bind_uint32/3

Bind an uint32 to the prepared statement at the specified index.

bind_uint64/3

Bind an uint64 to the prepared statement at the specified index.

bind_float/3

Bind an float to the prepared statement at the specified index. Note: Erlang's float() datatype is actually a DuckDB double. When binding an Erlang float variable you will lose precision.

bind_double/3

Bind an uint64 to the prepared statement at the specified index. Note: Erlang's float datatype is a DuckDB double. Using this function allows you to keep the precision.

bind_date/3

Bind a date to the prepared statement at the specified index. The date can be either given as a calendar:date() tuple, or an integer with the number of days since the first of January in the year 0.

bind_time/3

Bind a time to the prepared statement at the specified index. The time can be either given as an {hour, minute, second} tuple (similar to calendar:time()), or as an integer with the number of microseconds since midnight.

bind_timestamp/3

Bind a timestamp to the prepared statement at the specified index. The timestamp can be either a datetime tuple, or an integer with the microseconds since 1-Jan in the year 0.

bind_varchar/3

Bind a iolist as varchar to the prepared statement at the specified index. Note: This function is meant to bind null terminated strings in the database. Not arbitrary binary data.

bind_null/2

Bind a null value to the prepared statement at the specified index.

get_chunks/1

Get all data chunks from a query result.

get_chunk/2

Get a data chunk from a query result.

chunk_count/1

Get the number of data chunks in a query result.

column_names/1

Get the column names from the query result.

extract_chunk/1

Extract the data from a data chunk. Chunks contain multiple columns and rows. All data in the chunks is extracted.

get_chunk_column_count/1

Return the number of columns in the data chunk.

get_chunk_size/1

Return the number of tuples in th data chunk.

appender_create/3

Create an appender. Appenders allow for high speed bulk insertions into the database. See DuckDB Appender for more information.

append_boolean/2

Append a boolean value to the current location in the row.

append_int8/2

Append a tinyint to the current location in the row.

append_int16/2

Append a smallint to the current location in the row.

append_int32/2

Append an integer (32 bit) to the current location in the row.

append_int64/2

Append a bigint to the current location in the row.

append_uint8/2

Append a utinyint to the current location in the row.

append_uint16/2

Append a usmallint to the current location in the row.

append_uint32/2

Append an unsigned integer (32 bit) to the current location in the row.

append_uint64/2

Append a ubigint to the current location in the row.

append_float/2

Append a float to the current location in the row. Note: duckdb floats are different than erlang floats. When you add an erlang float to a duckdb float column, you will loose precision.

append_double/2

Append a double to the current location in the row. Note: duckdb double's are the same as erlang floats.

append_time/2

Append a time to the current location in the row.

append_date/2

Append a data to the current location in the row.

append_timestamp/2

Append a timestamp to the current location in the row.

append_varchar/2

Append a varchar to the current location in the row.

append_null/1

Append a null value to the current location in the row.

appender_end_row/1

Finalize the current row, and start a new one.

appender_flush/1

Flush the appender to the table, forcing the cache of the appender to be cleared and the data to be appended to the base table.

extract_result/1

Extract a query result of the first data chunk.

squery/2

Do a simple sql query without parameters, and retrieve the result from the first data chunk.

execute/1

Execute a prepared statement, and retrieve the first result from the first data chunk.

hugeint_to_integer/1

Convert a duckdb hugeint record to erlang integer.

integer_to_hugeint/1

Convert an erlang integer to a DuckDB hugeint.

uuid_binary_to_uuid_string/1

Convert a binary represented UUID to a printable hex representation.

uuid_string_to_uuid_binary/1

Convert a printable UUID to a binary representation.

Overview

Generated by EDoc