Difference between revisions of "CREATE DATABASE"

From Lianjapedia
Jump to: navigation, search
m (1 revision: SQL)
(See Also)
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Creates a database with the specified name
 
Creates a database with the specified name
 
  
 
==Syntax==
 
==Syntax==
 
CREATE DATABASE [IF NOT EXISTS] <database name>
 
CREATE DATABASE [IF NOT EXISTS] <database name>
  
 +
[METADATA <expC>]
  
 
==See Also==
 
==See Also==
[[ADATABASES()]], [[ADD TABLE]], [[ALTER INDEX]], [[ALTER TABLE]], [[BACKUP DATABASE]], [[CLOSE DATABASES]], [[CLOSE TABLES]], [[COMPILE DATABASE]], [[COPY DATABASE]], [[CREATE TABLE]], [[CREATE INDEX]], [[CREATE VIEW]], [[DATABASE()]], [[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]], [[PACK DATABASE]], [[REBUILD DATABASE]], [[REINDEX DATABASE]], [[REMOVE TABLE]], [[RESTORE DATABASE]], [[SET DATADIR]], [[SET EXCLUSIVE]], [[SQL USE|USE]]  
+
[[ADATABASES()]], [[ADD TABLE]], [[ALTER INDEX]], [[ALTER TABLE]], [[CLOSE DATABASES]], [[CLOSE TABLES]], [[COLUMNMETADATA()]],  
 
+
[[COMPILE DATABASE]], [[COPY DATABASE]], [[CREATE TABLE]], [[CREATE INDEX]], [[CREATE VIEW]], [[Custom Builders]], [[Database Events]], [[DATABASE()]], [[DATABASEMETADATA()]], [[DBUSED()]], [[DISPLAY DATABASE]], [[DISPLAY INDEXES]], [[DISPLAY SCHEMAS]], [[DISPLAY TABLES]], [[DROP DATABASE]], [[DROP INDEX]], [[DROP TABLE]], [[GETENV()]], [[LIST DATABASE]], [[LIST INDEXES]], [[LIST SCHEMAS]], [[LIST TABLES]], [[METADATA_DECODE()]], [[METADATA_ENCODE()]], [[METADATA_FINDTYPE()]], [[OPEN DATABASE]], [[PACK DATABASE]], [[REBUILD DATABASE]], [[REINDEX DATABASE]], [[REMOVE TABLE]], [[SET DATADIR]], [[SET EXCLUSIVE]], [[TABLEMETADATA()]], [[TABLEMETADATAVERSION()]], [[SQL USE|USE]]
  
 
==Description==
 
==Description==
 
The CREATE DATABASE command creates a new database with the specified name.  An error occurs if the database already exists unless the IF NOT EXISTS clause is specified.
 
The CREATE DATABASE command creates a new database with the specified name.  An error occurs if the database already exists unless the IF NOT EXISTS clause is specified.
  
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.  Since there are no tables in a database when it is initially created, the CREATE DATABASE statement creates an empty directory.  The directory is created as a sub-directory 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.
+
The METADATA <expC> clause is used to associate metadata with the database.  Database metadata is stored in the <database-basename>.cad file in the database's directory.
  
 +
See [[Lianja MetaData API]] for more information on creating and using MetaData.
 +
 +
After creation, the database will be open.
  
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
 
CREATE DATABASE hr
 
CREATE DATABASE hr
OPEN DATABASE hr
 
 
CREATE TABLE staff;
 
CREATE TABLE staff;
 
   (staff_no CHAR(6) NOT NULL UNIQUE,;
 
   (staff_no CHAR(6) NOT NULL UNIQUE,;
Line 32: Line 34:
 
   history LONG VARCHAR,;
 
   history LONG VARCHAR,;
 
   commission DECIMAL(4,1))
 
   commission DECIMAL(4,1))
 
// MySQL Compatible example
 
// cre_dat.sql
 
CREATE DATABASE hr;
 
USE hr;
 
CREATE TABLE staff
 
  (staff_no CHAR(6) NOT NULL UNIQUE,
 
  lastname CHAR(15) NOT NULL,
 
  firstname CHAR(10),
 
  hiredate DATE,
 
  location CHAR(15),
 
  supervisor CHAR(6),
 
  salary DECIMAL(6,0),
 
  picture VARBINARY,
 
  history LONG VARCHAR,
 
  commission DECIMAL(4,1));
 
 
</code>
 
</code>
  
  
==Products==
 
Recital Server, Recital
 
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:SQL]]
 
[[Category:SQL]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 
[[Category:Databases]]
 
[[Category:Databases]]
[[Category:Databases Commands]]
+
[[Category:Metadata API]]
 +
[[Category:Command Window CLI]]

Latest revision as of 07:43, 16 February 2021

Purpose

Creates a database with the specified name

Syntax

CREATE DATABASE [IF NOT EXISTS] <database name>

[METADATA <expC>]

See Also

ADATABASES(), ADD TABLE, ALTER INDEX, ALTER TABLE, CLOSE DATABASES, CLOSE TABLES, COLUMNMETADATA(), COMPILE DATABASE, COPY DATABASE, CREATE TABLE, CREATE INDEX, CREATE VIEW, Custom Builders, Database Events, DATABASE(), DATABASEMETADATA(), DBUSED(), DISPLAY DATABASE, DISPLAY INDEXES, DISPLAY SCHEMAS, DISPLAY TABLES, DROP DATABASE, DROP INDEX, DROP TABLE, GETENV(), LIST DATABASE, LIST INDEXES, LIST SCHEMAS, LIST TABLES, METADATA_DECODE(), METADATA_ENCODE(), METADATA_FINDTYPE(), OPEN DATABASE, PACK DATABASE, REBUILD DATABASE, REINDEX DATABASE, REMOVE TABLE, SET DATADIR, SET EXCLUSIVE, TABLEMETADATA(), TABLEMETADATAVERSION(), USE

Description

The CREATE DATABASE command creates a new database with the specified name. An error occurs if the database already exists unless the IF NOT EXISTS clause is specified.

The METADATA <expC> clause is used to associate metadata with the database. Database metadata is stored in the <database-basename>.cad file in the database's directory.

See Lianja MetaData API for more information on creating and using MetaData.

After creation, the database will be open.

Example

CREATE DATABASE hr
CREATE TABLE staff;
  (staff_no CHAR(6) NOT NULL UNIQUE,;
  lastname CHAR(15) NOT NULL,;
  firstname CHAR(10),;
  hiredate DATE,;
  location CHAR(15),;
  supervisor CHAR(6),;
  salary DECIMAL(6,0),;
  picture VARBINARY,;
  history LONG VARCHAR,;
  commission DECIMAL(4,1))