Name

PROBE-DATABASE — tests for existence of a databaseFunction

Syntax

probe-database connection-spec &key database-type => success

Arguments and Values

connection-spec

A connection specification

database-type

A database type specifier, i.e. a keyword. This defaults to the value of *default-database-type*

success

A boolean flag. If T, the database exists in the database system.

Description

This function tests for the existence of a database in the database system specified by database-type.

Examples

(probe-database '("localhost" "new" "dent" "dent") :database-type :postgresql)
=> T
	

Side Effects

None

Exceptional Situations

An exception maybe thrown if the database system does not receive administrator-level authentication since function may need to read the administrative database of the database system.

See Also

create-database
destroy-database
list-databases

Notes

probe-database is a CLSQL extension.