Using the utility database

The utility database is a phantom database with no physical representation. This feature allows you to execute database file administration statements such as CREATE DATABASE without first connecting to an existing physical database. The utility database has no database file, and therefore it cannot contain data.

The utility database is named utility_db. If you attempt to create or start a database with this name, the operation fails.

Executing the following statement after connecting to the utility database creates a database named new.db in the directory c:\temp.

CREATE DATABASE 'c:\\temp\\new.db';

See CREATE DATABASE statement.

You can also retrieve values of connection properties and server properties using the utility database.

For example, executing the following statement against the utility database returns the default collation sequence, which will be used when creating a database:

SELECT PROPERTY( 'DefaultCollation' );

For information about connection and database server properties, see:

Allowed statements for the utility database

Only the following statements can be executed when connected to the utility database:

ALTER DATABASE dbfile ALTER TRANSACTION LOG (see ALTER DATABASE statement)
CREATE DATABASE statement
CREATE DECRYPTED DATABASE statement
CREATE DECRYPTED FILE statement
CREATE ENCRYPTED DATABASE statement
CREATE ENCRYPTED FILE statement
DROP DATABASE statement
CREATE USER DBA IDENTIFIED BY new-password (see CREATE USER statement)
RESTORE DATABASE statement
REVOKE CONNECT FROM DBA (see REVOKE statement)
SET TEMPORARY OPTION progress_messages = [ OFF | RAW | FORMATTED ] (see SET OPTION statement)
SELECT statement without a FROM or WHERE clause (see SELECT statement)
START DATABASE statement
STOP DATABASE statement
STOP SERVER statement

Using the utility database

Allowed statements for the utility database

See also