PROBE-DATABASE
Prev | Connection and Initialisation | Next

## 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.

Prev | Up | Next
DESTROY-DATABASE | Home | LIST-DATABASES