CLOSE DATABASE

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Closes the currently open database


Syntax

CLOSE DATABASE [ALL]


See Also

ADATABASES(), ADD TABLE, ALTER INDEX, ALTER TABLE, BACKUP DATABASE, CLOSE TABLES, COMPILE DATABASE, COPY DATABASE, CREATE DATABASE, CREATE TABLE, CREATE INDEX, CREATE VIEW, DB_DATADIR, DBUSED(), DISPLAY DATABASE, DISPLAY INDEXES, DISPLAY SCHEMAS, DISPLAY TABLES, DROP DATABASE, DROP INDEX, DROP TABLE, GETENV(), LIST DATABASE, LIST INDEXES, LIST SCHEMAS, LIST TABLES, OPEN DATABASE, RESTORE DATABASE, SET AUTOCATALOG, SET EXCLUSIVE, SET GATEWAY, USE


Description

The CLOSE DATABASE command closes the currently open database and its tables. If no database is currently open, all tables and their associated files are closed.

Databases in Recital are implemented as directories containing files that correspond to the tables and associated files in the database. Operating System file protection can be applied individually to the files for added security. The directories are sub-directories of the Recital data directory. The environment variable DB_DATADIR points to the current Recital data directory and can be queried using the GETENV() function. Files from other directories can be added to the database using the ADD TABLE command or via the database catalog and SET AUTOCATALOG functionality.

CLOSE DATABASE does not close gateway sessions. The SET GATEWAY TO or CLOSE ALL commands can be used for this purpose.


Example

OPEN DATABASE hr EXCLUSIVE
SELECT staff_no, lastname from staff
CLOSE DATABASES

Products

Recital Server, Recital