summaryrefslogtreecommitdiffstats
path: root/docs/03_performance.mkd
diff options
context:
space:
mode:
authorJames Moger <james.moger@gmail.com>2011-08-17 13:30:40 -0400
committerJames Moger <james.moger@gmail.com>2011-08-17 13:30:40 -0400
commit05429c2cdf393730f17fb8fa51ee4b9e58e0a88f (patch)
tree1c6e98a2913b4f0912318e49f72f930b985eb345 /docs/03_performance.mkd
parent1734dc44d70391aeef26cacdf4d9f07c289e476e (diff)
downloadiciql-05429c2cdf393730f17fb8fa51ee4b9e58e0a88f.tar.gz
iciql-05429c2cdf393730f17fb8fa51ee4b9e58e0a88f.zip
Renamed logger. Improved test suite. Added Apache Commons and DBCP.v0.7.0
Diffstat (limited to 'docs/03_performance.mkd')
-rw-r--r--docs/03_performance.mkd6
1 files changed, 5 insertions, 1 deletions
diff --git a/docs/03_performance.mkd b/docs/03_performance.mkd
index 7df050a..12c07a1 100644
--- a/docs/03_performance.mkd
+++ b/docs/03_performance.mkd
@@ -9,7 +9,11 @@ Performance of iciql statement generation is not currently benchmarked.
### iciql+database performance comparison
-The following data was generated by running the iciql test suite. The suite is almost completely single-threaded. All Java databases are run in embedded *memory-only* mode through a JDBC connection.
+The following data was generated by running the *single-threaded* iciql test suite. All database connections are pooled and re-used within each execution of the test suite using [Apache Commons DBCP](http://commons.apache.org/dbcp).
+
+Connections are pooled to normalize embedded database performance with out-of-process database performance. Some of the Java embedded database configurations have a very high startup-time penalty. Notably, H2 is slow to open a database and its performance is substantially affected if connection pooling is not enabled to keep the embedded database open.
+
+All performance numbers include the combined overhead of iciql statement generation and JUnit 4 test framework execution so they are not bare-metal database metrics.
<pre>
%DBPERFORMANCE%