DATABASE

`CREATE DATABASE`

Objectif

Pour créer une nouvelle base de données.

Disponible en

DSQL, ESQL

Syntaxe

CREATE {DATABASE | SCHEMA} <filespec>
  [<db_initial_option> [<db_initial_option> ...]]
  [<db_config_option> [<db_config_option> ...]]

<db_initial_option> ::=
    USER username
  | PASSWORD 'password'
  | ROLE rolename
  | PAGE_SIZE [=] size
  | LENGTH [=] num [PAGE[S]]
  | SET NAMES 'charset'

<db_config_option> ::=
    DEFAULT CHARACTER SET default_charset
      [COLLATION collation]
  | <sec_file>
  | DIFFERENCE FILE 'diff_file'


<filespec> ::= '[<server_spec>]{filepath | db_alias}'

<server_spec> ::=
    host[/ {port | service}]:
  | \\host\
  | <protocol>://[host[:{port | service}]/]

<protocol> ::= inet | inet4 | inet6 | wnet | xnet

<sec_file> ::=
  FILE 'filepath'
  [LENGTH [=] num [PAGE[S]]
  [STARTING [AT [PAGE]] pagenum]

Note	Chaque option db_initial et db_config_option ne peut apparaître plus d’une fois, à l’exception de sec_file qui peut apparaître zéro fois ou plus.

Table 1. Paramètres de l’opérateur `CREATE DATABASE`
Paramètre	Description
filespec	Spécification du fichier de base de données primaire.
server_spec	Spécification du serveur distant.Comprend le nom et le protocole du serveur.Requis si la base de données est créée sur un serveur distant.
filepath	Chemin d’accès complet et nom du fichier, y compris l’extension.Le nom du fichier doit être spécifié en fonction des spécificités de la plate-forme utilisée.
db_alias	L’alias de la base de données présente dans le fichier databases.conf
host	Le nom du serveur ou l’adresse IP où la base de données est créée.
port	Le numéro du port sur lequel le serveur distant écoute (paramètre `RemoteServicePort` du fichier firebird.conf).
service	Nom du service.Doit correspondre à la valeur du paramètre `RemoteServiceName` du fichier firebird.conf.
protocol	Nom du protocole.
username	Le nom de l’utilisateur/propriétaire de la base de données.Il peut être entouré de guillemets simples ou doubles.Si le nom d’utilisateur est entre guillemets, il est sensible à la casse.
password	Le mot de passe de l’utilisateur/propriétaire de la base de données.Sensible à la casse.
role	Le nom du rôle dont les droits peuvent être pris en compte lors de la création de la base de données.Il peut être entouré de guillemets simples ou doubles.Si le nom du rôle est entre guillemets, il est sensible à la
size	Taille de la page pour la base de données.Valeurs valides : 4096, 8192, 16384, 32768.La taille de page par défaut est de 8192.
num	Taille maximale du fichier primaire ou secondaire en pages.
charset	Spécifie le jeu de caractères de la connexion disponible après la création réussie de la base de données.
default_charset	Spécifie le jeu de caractères par défaut pour les types de données de type chaîne.
collation	Le jeu de caractères pour le tri par défaut.
sec_file	Spécification du fichier secondaire.
pagenum	Le numéro de page à partir duquel le fichier de la base de données secondaire commence.
diff_file	Chemin et nom du fichier delta.

L’instruction CREATE DATABASE crée une nouvelle base de données.Vous pouvez utiliser CREATE DATABASE ou CREATE SCHEMA.Ce sont des synonymes.

Une base de données peut être constituée d’un ou plusieurs fichiers.Le premier fichier, primaire, est appelé le fichier principal, les autres fichiers sont appelés les fichiers secondaires.

Note	Actuellement, les bases de données multi-fichiers sont un atavisme.Il est logique d’utiliser des bases de données multi-fichiers sur les anciens systèmes de fichiers où la taille de chaque fichier est limitée.Par exemple, en FAT32, vous ne pouvez pas créer un fichier de plus de 4 gigaoctets.

La spécification du fichier primaire est le nom du fichier de la base de données et son extension, en précisant le chemin d’accès complet à celui-ci selon les règles du système d’exploitation utilisé.Le fichier de la base de données doit être absent lors de la création de la base de données.Sinon, un message d’erreur sera affiché et la base de données ne sera pas créée.Si le chemin complet de la base de données n’est pas spécifié, la base de données sera créée dans l’un des répertoires du système.Le choix du répertoire dépend du système d’exploitation.