Liking cljdoc? Tell your friends :D
Clojure only.

next.jdbc.plan

Some helper functions that make common operations with next.jdbc/plan much easier.

Some helper functions that make common operations with `next.jdbc/plan`
much easier.
raw docstring

select!clj

(select! connectable cols sql-params)
(select! connectable cols sql-params opts)

Execute the SQL and params using next.jdbc/plan and (by default) return a vector of rows with just the selected columns.

(plan/select! ds [:id :name] ["select * from table"])

If the cols argument is a vector of columns to select, then it is applied as:

(into [] (map #(select-keys % cols)) (jdbc/plan ...))

Otherwise, the cols argument is used as a function and mapped over the raw result set as:

(into [] (map cols) (jdbc/plan ...))

The usual caveats apply about operations on a raw result set that can be done without realizing the whole row.

Note: this allows for the following usage, which returns a vector of all the values for a single column:

(plan/select! ds :id ["select * from table"])

The result is a vector by default, but can be changed using the :into option to provide the initial data structure into which the selected columns are poured, e.g., :into #{}

Execute the SQL and params using `next.jdbc/plan` and (by default)
return a vector of rows with just the selected columns.

`(plan/select! ds [:id :name] ["select * from table"])`

If the `cols` argument is a vector of columns to select, then it is
applied as:

`(into [] (map #(select-keys % cols)) (jdbc/plan ...))`

Otherwise, the `cols` argument is used as a function and mapped over
the raw result set as:

`(into [] (map cols) (jdbc/plan ...))`

The usual caveats apply about operations on a raw result set that
can be done without realizing the whole row.

Note: this allows for the following usage, which returns a vector
of all the values for a single column:

`(plan/select! ds :id ["select * from table"])`

The result is a vector by default, but can be changed using the
`:into` option to provide the initial data structure into which
the selected columns are poured, e.g., `:into #{}`
sourceraw docstring

select-one!clj

(select-one! connectable cols sql-params)
(select-one! connectable cols sql-params opts)

Execute the SQL and params using next.jdbc/plan and return just the selected columns from just the first row.

(plan/select-one! ds [:total] ["select count(*) as total from table"]) ;;=> {:total 42}

If the cols argument is a vector of columns to select, then it is applied using select-keys, otherwise, the cols argument is used as a function directly. That means it can be a simple keyword to return just that column -- which is the most common expected usage:

(plan/select-one! ds :total ["select count(*) as total from table"]) ;;=> 42

The usual caveats apply about operations on a raw result set that can be done without realizing the whole row.

Execute the SQL and params using `next.jdbc/plan` and return just the
selected columns from just the first row.

`(plan/select-one! ds [:total] ["select count(*) as total from table"])`
;;=> {:total 42}

If the `cols` argument is a vector of columns to select, then it is
applied using `select-keys`, otherwise, the `cols` argument is used as
a function directly. That means it can be a simple keyword to return
just that column -- which is the most common expected usage:

`(plan/select-one! ds :total ["select count(*) as total from table"])`
;;=> 42

The usual caveats apply about operations on a raw result set that
can be done without realizing the whole row.
sourceraw docstring

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close