diff --git a/CHANGELOG.md b/CHANGELOG.md index 6ecade5..776d466 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,6 @@ +## 0.8.1-12 + * Two insert issues fixed and uuid support. + ## 0.8.1-11 * Optimization for very large (> 128 chars) strings. diff --git a/deps.edn b/deps.edn index 258021f..073c839 100644 --- a/deps.edn +++ b/deps.edn @@ -24,7 +24,7 @@ :exec-fn codox.main/-main :exec-args {:group-id "com.techascent" :artifact-id "tmducken" - :version "0.8.1-12-SNAPSHOT" + :version "0.8.1-12" :name "TMDucken" :description "Clojure bindings for duckdb" :metadata {:doc/format :markdown} diff --git a/docs/index.html b/docs/index.html index 75c1a59..ad1ca53 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,8 +1,8 @@ -TMDucken 0.8.1-11

Project

Namespaces

TMDucken 0.8.1-11

Clojure bindings for duckdb.

Namespaces

tmducken.duckdb

DuckDB C-level bindings for tech.ml.dataset.

-

Public variables and functions:

\ No newline at end of file + gtag('config', 'G-XJYNJF48RM');

Project

Namespaces

TMDucken 0.8.1-12

Clojure bindings for duckdb.

Namespaces

tmducken.duckdb

DuckDB C-level bindings for tech.ml.dataset.

+

Public variables and functions:

\ No newline at end of file diff --git a/docs/tmducken.duckdb.html b/docs/tmducken.duckdb.html index d44392a..64d245b 100644 --- a/docs/tmducken.duckdb.html +++ b/docs/tmducken.duckdb.html @@ -4,11 +4,12 @@ function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); - gtag('config', 'G-XJYNJF48RM');

Project

Namespaces

Public Vars

tmducken.duckdb

DuckDB C-level bindings for tech.ml.dataset.

+ gtag('config', 'G-XJYNJF48RM');

Project

Namespaces

Public Vars

tmducken.duckdb

DuckDB C-level bindings for tech.ml.dataset.

Current datatype support:

  • boolean, all numeric types int8->int64, uint8->uint64, float32, float64.
  • string
    • +
  • uuid
  • LocalDate, Instant column types.

Example:

@@ -45,9 +46,9 @@ | MSFT | 2000-05-01 | 25.45 |

close-db

(close-db db)

Close the database.

-
view source

connect

(connect db)

Create a new database connection from an opened database. +

view source

connect

(connect db)

Create a new database connection from an opened database. Users should call disconnect to close this connection.

-
view source

create-table!

(create-table! conn dataset options)(create-table! conn dataset)

Create an sql table based off of the column datatypes of the dataset. Note that users +

view source

create-table!

(create-table! conn dataset options)(create-table! conn dataset)

Create an sql table based off of the column datatypes of the dataset. Note that users can also call execute-query! with their own sql create-table string. Note that the fastest way to get data into the system is append-dataset!.

Options:

@@ -56,10 +57,10 @@ be used.
  • :primary-key - sequence of column names to be used as the primary key.
    • -
    view source

    disconnect

    (disconnect conn)

    Disconnect a connection.

    -
    view source

    drop-table!

    (drop-table! conn dataset)
    view source

    get-config-options

    (get-config-options)

    Returns a sequence of maps of {:name :desc} describing valid valid configuration +

    view source

    delayed-clone

    (delayed-clone this)

    disconnect

    (disconnect conn)

    Disconnect a connection.

    +
    view source

    drop-table!

    (drop-table! conn dataset)
    view source

    get-config-options

    (get-config-options)

    Returns a sequence of maps of {:name :desc} describing valid valid configuration options to the open-db function.

    -
    view source

    initialize!

    (initialize! {:keys [duckdb-home]})(initialize!)

    Initialize the duckdb ffi system. This must be called first should be called only once. +

    view source

    initialize!

    (initialize! {:keys [duckdb-home]})(initialize!)

    Initialize the duckdb ffi system. This must be called first should be called only once. It is safe, however, to call this multiple times.

    Options:

      @@ -68,10 +69,10 @@ neither is passed in then the library will be searched in the normal system library paths.
    -
    view source

    initialized?

    (initialized?)
    view source

    insert-dataset!

    (insert-dataset! conn dataset options)(insert-dataset! conn dataset)

    Append this dataset using the higher performance append api of duckdb. This is recommended +

    view source

    initialized?

    (initialized?)
    view source

    insert-dataset!

    (insert-dataset! conn dataset options)(insert-dataset! conn dataset)

    Append this dataset using the higher performance append api of duckdb. This is recommended as opposed to using sql statements or prepared statements. That being said the schema of this dataset must match precisely the schema of the target table.

    -
    view source

    open-db

    (open-db path config-options)(open-db path)(open-db)

    Open a database. path may be nil in which case database is opened in-memory. +

    view source

    open-db

    (open-db path config-options)(open-db path)(open-db)

    Open a database. path may be nil in which case database is opened in-memory. For valid config options call get-config-options. Options must be passed as a map of string->string. As duckdb is dynamically linked configuration options may change but with linux-amd64-0.3.1 current options are:

    @@ -90,7 +91,7 @@ {:name "max_memory", :desc "The maximum memory of the system (e.g. 1GB)"} {:name "threads", :desc "The number of total threads used by the system"}] -
    view source

    prepare

    (prepare conn sql)(prepare conn sql options)

    Create a prepared statement returning a clojure function you can call taking args specified +

    view source

    prepare

    (prepare conn sql)(prepare conn sql options)

    Create a prepared statement returning a clojure function you can call taking args specified in the prepared statement. This function is auto-closeable which releases the prepared statement - it is also registered with the resource system so it will be released when it is no longer reachable by the gc system.

    The function return value can be either a sequence of datasets or a single dataset. For :streaming, the sequence @@ -144,11 +145,11 @@ | MSFT | 2000-04-01 | 28.37 | | MSFT | 2000-05-01 | 25.45 | -

    view source

    run-query!

    (run-query! conn sql options)(run-query! conn sql)

    Run a query ignoring the results. Useful for queries such as single-row insert or update where +

    view source

    run-query!

    (run-query! conn sql options)(run-query! conn sql)

    Run a query ignoring the results. Useful for queries such as single-row insert or update where you don't care about the results.

    -
    view source

    sql->dataset

    (sql->dataset conn sql options)(sql->dataset conn sql)

    Execute a query returning a single dataset. This runs the query in a context that releases the memory used +

    view source

    sql->dataset

    (sql->dataset conn sql options)(sql->dataset conn sql)

    Execute a query returning a single dataset. This runs the query in a context that releases the memory used for the result set before function returns returning a dataset that has no native bindings.

    -
    view source

    sql->datasets

    (sql->datasets conn sql options)(sql->datasets conn sql)

    Execute a query returning either a sequence of datasets or a single dataset.

    +
    view source

    sql->datasets

    (sql->datasets conn sql options)(sql->datasets conn sql)

    Execute a query returning either a sequence of datasets or a single dataset.

    See documentation and options for prepare.

    Examples:

    tmducken.duckdb> (first (sql->datasets conn "select * from stocks"))
@@ -177,4 +178,4 @@
 |   MSFT | 2000-04-01 | 28.37 |
 |   MSFT | 2000-05-01 | 25.45 |
    -
    view source
    \ No newline at end of file +
    view source
    \ No newline at end of file diff --git a/src/tmducken/duckdb.clj b/src/tmducken/duckdb.clj index c091252..4559828 100644 --- a/src/tmducken/duckdb.clj +++ b/src/tmducken/duckdb.clj @@ -5,6 +5,7 @@ * boolean, all numeric types int8->int64, uint8->uint64, float32, float64. * string + * uuid * LocalDate, Instant column types.