Once the database type has been initialized a connection can be established by calling connect with an appropriate
connection-spec
. A call to connect sets *default-database* to the database instance which represents the connection. All the other database functions described take a
:database
argument that can be either a database or a database name, and which defaults to the value of *default-database*.
Database connections can be named by passing the
:name
argument to connect, allowing you to have more than one connection to a given database. If this is omitted, then a unique database name is constructed from
connection-spec
and a counter. Connection names are compared with
equalp
.
To find all the database connection instances, call the function connected-databases. To retrieve the name for a connection instance, call database-name, and to find a connection instance with a given name use find-database. To print status information about the existing connections, call status.
To close a connection to a database, use disconnect.
To reestablish a connection to a database, use reconnect.