Difference between revisions of "BACKUP DATABASE"

From Recital Documentation Wiki
Jump to: navigation, search
(Description)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=BACKUP DATABASE=
 
 
 
==Class==
 
Databases
 
 
 
 
==Purpose==
 
==Purpose==
 
Exports bridge, table, and associated files from the current or specified database in ASCII format to allow them to be transferred to a binary incompatible platform
 
Exports bridge, table, and associated files from the current or specified database in ASCII format to allow them to be transferred to a binary incompatible platform
Line 15: Line 8:
  
 
==See Also==
 
==See Also==
[[ADATABASES()]], [[ADD TABLE]], [[ALTER INDEX]], [[ALTER TABLE]], [[BUILD]], [[CLOSE TABLES]], [[COMPILE DATABASE]], [[CREATE DATABASE]], [[CREATE TABLE]], [[CREATE INDEX]], [[CREATE VIEW]], [[DATABASE()]], [[DB_DATADIR]], [[DBUSED()]], [[DISPLAY DATABASE]], [[DISPLAY INDEXES]], [[DISPLAY TABLES]], [[DROP DATABASE]], [[DROP INDEX]], [[DROP TABLE]], [[GETENV()]], [[INSTALL]], [[LIST DATABASE]], [[LIST INDEXES]], [[LIST TABLES]], [[OPEN DATABASE]], [[PACK DATABASE]], [[REBUILD DATABASE]], [[REINDEX DATABASE]], [[RESTORE DATABASE]], [[SET EXCLUSIVE]], [[SQL USE|USE]]
+
[[ADATABASES()]], [[ADD TABLE]], [[ALTER INDEX]], [[ALTER TABLE]], [[BUILD]], [[CLOSE TABLES]], [[COMPILE DATABASE]], [[Configuration Files]], [[COPY DATABASE]], [[CREATE DATABASE]], [[CREATE TABLE]], [[CREATE INDEX]], [[CREATE VIEW]], [[DATABASE()]], [[DB_BACKUPDIR]], [[DB_DATADIR]], [[DBUSED()]], [[DISPLAY DATABASE]], [[DISPLAY INDEXES]], [[DISPLAY SCHEMAS]], [[DISPLAY TABLES]], [[DROP DATABASE]], [[DROP INDEX]], [[DROP TABLE]], [[GETENV()]], [[INSTALL]], [[LIST DATABASE]], [[LIST INDEXES]], [[LIST SCHEMAS]], [[LIST TABLES]], [[OPEN DATABASE]], [[PACK DATABASE]], [[REBUILD DATABASE]], [[REINDEX DATABASE]], [[RESTORE DATABASE]], [[SET AUTOCATALOG]], [[SET EXCLUSIVE]], [[SQL USE|USE]]
  
  
Line 21: Line 14:
 
The BACKUP DATABASE command issues a BUILD on the bridge files, tables and associated memo, dictionary and multiple index files from the currently open database or specified database.  This exports these files into ASCII format to allow them to be transferred to a binary incompatible platform.
 
The BACKUP DATABASE command issues a BUILD on the bridge files, tables and associated memo, dictionary and multiple index files from the currently open database or specified database.  This exports these files into ASCII format to allow them to be transferred to a binary incompatible platform.
  
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 / symbol 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.
+
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.
  
If the <database name> is omitted, the BACKUP DATABASE command will operate on the active database.  If no database is currently open, an error will be returned.  If the question mark, '?', is included instead of the <database name>, the 'SELECT A FILE' dialog will be displayed, allowing the user to select a database.  The dialog defaults to the DB_DATADIR directory.  This is only applicable for Recital Terminal Developer: for Recital Database and Mirage Servers, the <database name> must be specified if the required database is not already open.
+
If the <database name> is omitted, the BACKUP DATABASE command will operate on the active database.  If no database is currently open, an error will be returned.  If the question mark, '?', is included instead of the <database name>, the 'SELECT A FILE' dialog will be displayed, allowing the user to select a database.  The dialog defaults to the DB_DATADIR directory.  This is only applicable for Recital: for Recital Server, the <database name> must be specified if the required database is not already open.
  
 
The ASCII files are created in a sub-directory of the Recital backup directory.  The environment variable / symbol DB_BACKUPDIR points to the current Recital backup directory and can be queried using the GETENV() function.  The sub-directory is created automatically and has the same name as the database.  If the sub-directory already exists, any files it previously contained are deleted.  Once the BACKUP DATABASE has completed successfully, the sub-directory and its contents can be copied to the DB_BACKUPDIR directory on another platform and the database recreated using the RESTORE DATABASE command.
 
The ASCII files are created in a sub-directory of the Recital backup directory.  The environment variable / symbol DB_BACKUPDIR points to the current Recital backup directory and can be queried using the GETENV() function.  The sub-directory is created automatically and has the same name as the database.  If the sub-directory already exists, any files it previously contained are deleted.  Once the BACKUP DATABASE has completed successfully, the sub-directory and its contents can be copied to the DB_BACKUPDIR directory on another platform and the database recreated using the RESTORE DATABASE command.
 
  
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
 
// On Source machine:
 
// On Source machine:
Recital/SQL> backup database southwind;
+
backup database southwind
  
 
// Transfer southwind sub-directory from DB_BACKUPDIR on source machine
 
// Transfer southwind sub-directory from DB_BACKUPDIR on source machine
Line 37: Line 29:
  
 
// On Target Machine
 
// On Target Machine
Recital/SQL> restore database southwind;
+
restore database southwind
 
</code>
 
</code>
  
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:SQL]]
 
[[Category:SQL]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Databases]]
 +
[[Category:Databases Commands]]

Latest revision as of 09:21, 11 October 2010

Purpose

Exports bridge, table, and associated files from the current or specified database in ASCII format to allow them to be transferred to a binary incompatible platform


Syntax

BACKUP DATABASE [<database name> | ?]


See Also

ADATABASES(), ADD TABLE, ALTER INDEX, ALTER TABLE, BUILD, CLOSE TABLES, COMPILE DATABASE, Configuration Files, COPY DATABASE, CREATE DATABASE, CREATE TABLE, CREATE INDEX, CREATE VIEW, DATABASE(), DB_BACKUPDIR, DB_DATADIR, DBUSED(), DISPLAY DATABASE, DISPLAY INDEXES, DISPLAY SCHEMAS, DISPLAY TABLES, DROP DATABASE, DROP INDEX, DROP TABLE, GETENV(), INSTALL, LIST DATABASE, LIST INDEXES, LIST SCHEMAS, LIST TABLES, OPEN DATABASE, PACK DATABASE, REBUILD DATABASE, REINDEX DATABASE, RESTORE DATABASE, SET AUTOCATALOG, SET EXCLUSIVE, USE


Description

The BACKUP DATABASE command issues a BUILD on the bridge files, tables and associated memo, dictionary and multiple index files from the currently open database or specified database. This exports these files into ASCII format to allow them to be transferred to a binary incompatible platform.

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.

If the <database name> is omitted, the BACKUP DATABASE command will operate on the active database. If no database is currently open, an error will be returned. If the question mark, '?', is included instead of the <database name>, the 'SELECT A FILE' dialog will be displayed, allowing the user to select a database. The dialog defaults to the DB_DATADIR directory. This is only applicable for Recital: for Recital Server, the <database name> must be specified if the required database is not already open.

The ASCII files are created in a sub-directory of the Recital backup directory. The environment variable / symbol DB_BACKUPDIR points to the current Recital backup directory and can be queried using the GETENV() function. The sub-directory is created automatically and has the same name as the database. If the sub-directory already exists, any files it previously contained are deleted. Once the BACKUP DATABASE has completed successfully, the sub-directory and its contents can be copied to the DB_BACKUPDIR directory on another platform and the database recreated using the RESTORE DATABASE command.

Example

// On Source machine:
backup database southwind
 
// Transfer southwind sub-directory from DB_BACKUPDIR on source machine
// to DB_BACKUPDIR on target machine
 
// On Target Machine
restore database southwind


Products

Recital Server, Recital