STOP DATABASE statement

Use this statement to stop a database on the current database server.

Syntax
STOP DATABASE database-name
[ ON database-server-name ]
[ UNCONDITIONALLY ]
Parameters
  • STOP DATABASE clause   The database-name is the name of a database (other than the current database) running on the current server.

  • ON clause   This clause is supported in Interactive SQL only. If database-server-name is not specified in Interactive SQL, all running servers are searched for a database of the specified name.

    When not using this statement in Interactive SQL, the database is stopped only if it is started on the current database server.

  • UNCONDITIONALLY clause   Stop the database even if there are connections to the database. By default, the database is not stopped if there are connections to it.

Remarks

The STOP DATABASE statement stops a specified database on the current database server.

Permissions

The required permissions are specified by the database server -gk option. This option defaults to all on the personal database server, and DBA on the network server.

You cannot use STOP DATABASE on the database to which you are currently connected.

Side effects

None

See also
Standards and compatibility
  • SQL/2003   Vendor extension.

Example

Stop the database named sample on the current server.

STOP DATABASE sample;