From de432a224528dcea779ed188dbc107704a920186 Mon Sep 17 00:00:00 2001 From: Sean Corfield Date: Sat, 25 Sep 2021 15:44:31 -0700 Subject: [PATCH] prep for 1.2.724 --- CHANGELOG.md | 4 +++- README.md | 4 ++-- doc/getting-started.md | 6 +++--- doc/tips-and-tricks.md | 4 ++++ 4 files changed, 12 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2b8b7ba..76993a9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,7 +2,9 @@ Only accretive/fixative changes will be made from now on. -* 1.2.next in progress +* 1.2.724 -- 2021-09-25 + * Make `next.jdbc` compatible with GraalVM 22+ (PR #178, @FieryCod). + * Address #177 by adding an important performance tip for Oracle. * Update most of the JDBC drivers for testing; make it easier to test MariaDB's driver; * 1.2.709 -- 2021-08-30 diff --git a/README.md b/README.md index ae04b06..47e2ee3 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ The next generation of `clojure.java.jdbc`: a new low-level Clojure wrapper for The latest versions on Clojars and on cljdoc: -[![Clojars Project](https://clojars.org/com.github.seancorfield/next.jdbc/latest-version.svg)](https://clojars.org/com.github.seancorfield/next.jdbc) [![cljdoc badge](https://cljdoc.org/badge/com.github.seancorfield/next.jdbc?1.2.709)](https://cljdoc.org/d/com.github.seancorfield/next.jdbc/CURRENT) +[![Clojars Project](https://clojars.org/com.github.seancorfield/next.jdbc/latest-version.svg)](https://clojars.org/com.github.seancorfield/next.jdbc) [![cljdoc badge](https://cljdoc.org/badge/com.github.seancorfield/next.jdbc?1.2.724)](https://cljdoc.org/d/com.github.seancorfield/next.jdbc/CURRENT) The documentation on [cljdoc.org](https://cljdoc.org/d/com.github.seancorfield/next.jdbc/CURRENT) is for the current version of `next.jdbc`: @@ -17,7 +17,7 @@ The documentation on [cljdoc.org](https://cljdoc.org/d/com.github.seancorfield/n * [Migrating from `clojure.java.jdbc`](https://cljdoc.org/d/com.github.seancorfield/next.jdbc/CURRENT/doc/migration-from-clojure-java-jdbc) * Feedback via [issues](https://github.com/seancorfield/next-jdbc/issues) or in the [`#sql` channel on the Clojurians Slack](https://clojurians.slack.com/messages/C1Q164V29/) or the [`#sql` stream on the Clojurians Zulip](https://clojurians.zulipchat.com/#narrow/stream/152063-sql). -The documentation on GitHub is for **develop** since the 1.2.709 release -- [see the CHANGELOG](https://github.com/seancorfield/next-jdbc/blob/develop/CHANGELOG.md) and then read the [corresponding updated documentation](https://github.com/seancorfield/next-jdbc/tree/develop/doc) on GitHub if you want. Older versions of `next.jdbc` were published under the `seancorfield` group ID and you can find [older seancorfield/next.jdbc documentation on cljdoc.org](https://cljdoc.org/versions/seancorfield/next.jdbc). +The documentation on GitHub is for **develop** since the 1.2.724 release -- [see the CHANGELOG](https://github.com/seancorfield/next-jdbc/blob/develop/CHANGELOG.md) and then read the [corresponding updated documentation](https://github.com/seancorfield/next-jdbc/tree/develop/doc) on GitHub if you want. Older versions of `next.jdbc` were published under the `seancorfield` group ID and you can find [older seancorfield/next.jdbc documentation on cljdoc.org](https://cljdoc.org/versions/seancorfield/next.jdbc). This project follows the version scheme MAJOR.MINOR.COMMITS where MAJOR and MINOR provide some relative indication of the size of the change, but do not follow semantic versioning. In general, all changes endeavor to be non-breaking (by moving to new names rather than by breaking existing names). COMMITS is an ever-increasing counter of commits since the beginning of this repository. diff --git a/doc/getting-started.md b/doc/getting-started.md index 5eeb75e..5142789 100644 --- a/doc/getting-started.md +++ b/doc/getting-started.md @@ -11,12 +11,12 @@ It is designed to work with Clojure 1.10 or later, supports `datafy`/`nav`, and You can add `next.jdbc` to your project with either: ```clojure -com.github.seancorfield/next.jdbc {:mvn/version "1.2.709"} +com.github.seancorfield/next.jdbc {:mvn/version "1.2.724"} ``` for `deps.edn` or: ```clojure -[com.github.seancorfield/next.jdbc "1.2.709"] +[com.github.seancorfield/next.jdbc "1.2.724"] ``` for `project.clj` or `build.boot`. @@ -37,7 +37,7 @@ For the examples in this documentation, we will use a local H2 database on disk, ```clojure ;; deps.edn {:deps {org.clojure/clojure {:mvn/version "1.10.3"} - com.github.seancorfield/next.jdbc {:mvn/version "1.2.709"} + com.github.seancorfield/next.jdbc {:mvn/version "1.2.724"} com.h2database/h2 {:mvn/version "1.4.199"}}} ``` diff --git a/doc/tips-and-tricks.md b/doc/tips-and-tricks.md index 2663a4e..bdaaf15 100644 --- a/doc/tips-and-tricks.md +++ b/doc/tips-and-tricks.md @@ -137,6 +137,10 @@ You should be able to get MySQL to stream very large result sets (when you are r Ah, dear old Oracle! Over the years of maintaining `clojure.java.jdbc` and now `next.jdbc`, I've had all sorts of bizarre and non-standard behavior reported from Oracle users. The main issue I'm aware of with `next.jdbc` is that Oracle's JDBC drivers all return an empty string from `ResultSetMetaData.getTableName()` so you won't get qualified keywords in the result set hash maps. Sorry! +An important performance issue to be aware of with Oracle's JDBC driver is that the default fetch size is just 10 records. If you are working with large datasets, you will +either need to either specify `:prefetch` in your db-spec hash map with a suitable value (say 1,000 or larger), or specify `&prefetch=` in your JDBC URL string. If you want +to keep the default, you can change it on a per-statement basis by specifying `:fetch-size` as an option to `execute!` etc. + ## PostgreSQL When you use `:return-keys true` with `execute!` or `execute-one!` (or you use `insert!`), PostgreSQL returns the entire inserted row (unlike nearly every other database that just returns any generated keys!).