DROP DATABASE statement

Description

Drops a database and its associated dbspace segment files.

Syntax

DROP DATABASE db-filenameKEY key-spec ] 

Parameters

key-spec:

A string, including mixed cases, numbers, letters, and special characters. It might be necessary to protect the key from interpretation or alteration by the command shell.

Examples

Example 1

Drops database mydb:

DROP DATABASE 'mydb.db'

Example 2

Drops the encrypted database marvin.db, which was created with the key is!seCret:

DROP DATABASE 'marvin.db' KEY 'is!seCret'

Example 3

This UNIX example drops the database temp.db from the /s1/temp directory:

DROP DATABASE '/s1/temp/temp.db'

Usage

DROP DATABASE drops all the database segment files associated with the IQ store and temporary store before it drops the catalog store files.

You must stop a database before you can drop it. If the connection parameter AUTOSTOP=no is used, you may need to issue a STOP DATABASE statement.

The db-filename you specify corresponds to the database file name you defined for the database using CREATE DATABASE. If you specified a directory path for this value in the CREATE DATABASE command, you must also specify the directory path for DROP DATABASE. Otherwise, Sybase IQ looks for the database files in the default directory where the server files reside.

You cannot execute a DROP DATABASE statement to drop an IQ database that has a DatabaseStart event defined for it.


Side effects

None

Standards

Permissions

Required permissions are set using the database server -gu command line option. The default setting is to require DBA authority.

See also

CREATE DATABASE statement