X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fref-connect.xml;h=c3879b22ea71be587c2c315eed3d1fe1cc4d0dc2;hb=4871b9ef13ed1cf4f7ef927bd026ca19e845f53c;hp=35b8cf56b30aef8a446c903a152db9d7763eaf54;hpb=4413405fd38eaba7ba6d6d8b844fef118e326c9a;p=clsql.git
diff --git a/doc/ref-connect.xml b/doc/ref-connect.xml
index 35b8cf5..c3879b2 100644
--- a/doc/ref-connect.xml
+++ b/doc/ref-connect.xml
@@ -125,6 +125,60 @@
None.
+
+
+ *DB-POOL-MAX-FREE-CONNECTIONS*
+
+
+ *DB-POOL-MAX-FREE-CONNECTIONS*
+ How many free connections should the connection pool try to keep.
+ Parameter
+
+
+ Value Type
+ Integer
+
+
+ Initial Value
+ 4
+
+
+ Description
+ Threshold of free-connections in the pool before we disconnect a
+ database rather than returning it to the pool. This is really a heuristic
+that should, on avg keep the free connections about this size.
+
+ This is not a hard limit, the number of connections in
+ the pool may exceed this value.
+
+
+
+ Examples
+
+ (setf clsql-sys:*db-pool-max-free-connections* 2)
+
+
+
+ Affected By
+ None
+
+
+ See Also
+
+
+ connect
+ disconnect
+
+
+
+
+ Notes
+
+
+
+
+
+
@@ -379,8 +433,14 @@
connection-spec
- A vendor specific connection specification supplied
- as a list or as a string.
+ A SQL backend specific connection specification
+ supplied as a list or as a string.
+ For the MySQL backend, this list includes an
+ optional associative list of connection options. The
+ options list is parsed and supplied to the MySQL API
+ using mysql_options in between the
+ calls to mysql_init
+ and mysql_real_connect.
@@ -544,8 +604,16 @@
Affected by
- *default-database-type*
- *connect-if-exists*
+
+
+ *default-database-type*
+
+
+
+
+ *connect-if-exists*
+
+
@@ -1066,24 +1134,46 @@
Side Effects
- The database connection is closed, and the database
- object is removed from the list of connected databases as
- returned by connected-databases.
- The state of the database object is changed to
- closed.
+ The database object is removed from the list of connected databases as
+ returned by connected-databases.If the database object passed is the same under
- eq as the value of
- *default-database*, then
- *default-database* is set to the first
- remaining database from
- connected-databases or to &nil; if no
- further active database exists.
+ eq as the value of
+ *default-database*, then
+ *default-database* is set to the first
+ remaining database from
+ connected-databases or to &nil; if no
+ further active database exists.
+
+ Non-pooled
+ The database connection is closed and the state of the
+ database object is changed to closed.
+
+
+ Pooled
+ Unless there are already
+ *db-pool-max-free-connections*
+ free connections in the pool it is returned to the
+ pool, with the backend having an opportunity to run
+ generic cleanup on the connection first. If the max free
+ connections has already been reached then it is
+ disconnected as if it were not in the pool.
+
+ Affected by
- *default-database*
+
+
+ *default-database*
+
+
+
+
+ *db-pool-max-free-connections*
+
+
@@ -1120,7 +1210,7 @@
Syntax
- disconnect-pooled => t
+ disconnect-pooled &optional clear => tDescription
@@ -1129,6 +1219,8 @@
linkend="connect">connect with
:pool &t;.
+ If optional argument clear is non-&nil;
+ then the connection-pool objects are also removed.Examples
@@ -1139,8 +1231,10 @@
Side Effects
- Database connections will be closed and entries in the pool are removed.
-
+ Database connections will be closed and *all* entries in
+ the pool are removed. This is done with great prejudice and no
+ thought to thread safety or whether that connection is
+ currently in use.Affected by
@@ -1825,7 +1919,7 @@ error: 'Access denied for user: 'root@localhost' (Using password: YES)'
=>
Error: While trying to access database localhost/test2/root
using database-type POSTGRESQL:
- Error database-destory failed: dropdb: database removal failed: ERROR: database "test2" does not exist
+ Error database-destroy failed: dropdb: database removal failed: ERROR: database "test2" does not exist
has occurred.
[condition type: CLSQL-ACCESS-ERROR]
@@ -2068,7 +2162,7 @@ Error: While trying to access database localhost/test2/root
db-var
- A variable to which the specified database is bound.
+ A variable which is bound to the specified database.
@@ -2082,7 +2176,12 @@ Error: While trying to access database localhost/test2/root
connect-args
- Other optional arguments to connect.
+ Other optional arguments to
+ connect. This macro use a value of
+ &nil; for connect's
+ make-default key, This is in
+ contrast to to the connect function which has a default
+ value of &t; for make-default.