Exemples

Language de définition des données (DDL)SHADOW

Exemples

Example 1. Création d’une base de données dans un système d’exploitation Windows

Création d’une base de données sur un système d’exploitation Windows situé sur le lecteur D avec une taille de page de 8192.Le propriétaire de la base de données sera l’utilisateur assistant.La base de données sera en dialecte 1, et utilisera le jeu de caractères par défaut WIN1251.

SET SQL DIALECT 1;
CREATE DATABASE 'D:\test.fdb'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET WIN1251;

Example 2. Création d’une base de données dans un système d’exploitation Linux

Création d’une base de données sur un système d’exploitation Linux avec une taille de page de 4096.Le propriétaire de la base de données sera l’utilisateur assistant.La base de données sera en dialecte 3, et utilisera le jeu de caractères par défaut UTF8 avec un tri diminué UNICODE_CI_AI.

CREATE DATABASE '/home/firebird/test.fdb'
USER "wizard" PASSWORD 'player' ROLE 'RDB$ADMIN'
PAGE_SIZE = 4096
DEFAULT CHARACTER SET UTF8 COLLATION UNICODE_CI_AI;

Important

Dans ce cas, la base de données sera sensible à la casse pour le nom d’utilisateur car il est spécifié entre guillemets.

Example 3. Création d’une base de données sur un serveur distant

Création d’une base de données sur le serveur de base distant situé au niveau du chemin référencé par l’alias test décrit dans le fichier databases.conf.Le protocole utilisé est le TCP.Le propriétaire de la base de données sera l’assistant utilisateur.

CREATE DATABASE 'baseserver:test'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET UTF8;

Il en va de même pour l’utilisation d’une syntaxe unifiée de type URL pour spécifier un serveur distant.

CREATE DATABASE 'inet://baseserver:3050/test'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET UTF8;

CREATE DATABASE 'inet://baseserver:gds_db/test'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET UTF8;

Lorsque vous utilisez des noms de domaine, il peut être utile de préciser quel protocole IP v4 ou IP v6 vous souhaitez utiliser.

CREATE DATABASE 'inet4://baseserver/test'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET UTF8;

CREATE DATABASE 'inet6://baseserver/test'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET UTF8;

Création d’une base de données avec une adresse IP (IPv4) au lieu d’un nom de serveur.

CREATE DATABASE '127:0:0:1:test'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET UTF8;

Création d’une base de données avec une adresse IP (IPv6) au lieu d’un nom de serveur.

CREATE DATABASE '[::1]:test'
USER wizard PASSWORD 'player' ROLE RDB$ADMIN
DEFAULT CHARACTER SET UTF8;

Example 4. Création d’une base de données multi-fichiers

Création d’une base de données en dialecte 3 avec le jeu de caractères par défaut UTF8.Le fichier primaire contiendra 10000 pages avec une taille de page de 8192.Dès que le processus de base de données remplit le fichier primaire, le SGBD place de nouvelles données dans le fichier secondaire test.fdb2.Les mêmes actions se produiront avec le deuxième fichier secondaire.La taille du dernier fichier augmentera tant que le système d’exploitation le permettra ou tant que la mémoire du périphérique de stockage externe ne sera pas épuisée.

SET SQL DIALECT 3;
CREATE DATABASE 'baseserver:D:\test.fdb'
USER wizard PASSWORD 'player' ROLE 'RDB$ADMIN'
PAGE_SIZE = 8192
DEFAULT CHARACTER SET UTF8
FILE 'D:\test.fdb2'
STARTING AT PAGE 10001
FILE 'D:\test.fdb3'
STARTING AT PAGE 20001;

Example 5. Création d’une base de données multi-fichiers 2

SET SQL DIALECT 3;
CREATE DATABASE 'baseserver:D:\test.fdb'
USER wizard PASSWORD 'player' ROLE 'RDB$ADMIN'
PAGE_SIZE = 8192
LENGTH 10000 PAGES
DEFAULT CHARACTER SET UTF8
FILE 'D:\test.fdb2'
FILE 'D:\test.fdb3'
STARTING AT PAGE 20001;

Voir aussi :

[fblangref-ddl-database-alter], [fblangref-ddl-database-drop].

`ALTER DATABASE`

Objectif

Pour modifier la structure des fichiers de la base de données, la mettre en "sécurité pour la copie" ou modifier certaines propriétés de la base de données.

Disponible en

DSQL, ESQL

Syntaxe

ALTER {DATABASE | SCHEMA}
    {<add_sec_clause> [<add_sec_clausee> ...]}
  | {ADD DIFFERENCE FILE 'diff_file' | DROP DIFFERENCE FILE}
  | {{BEGIN | END} BACKUP}
  | {SET DEFAULT CHARACTER SET charset}
  | {SET DEFAULT SQL SECURITY {DEFINER | INVOKER}}
  | {SET LINGER TO linger_duration | DROP LINGER}
  | {ENCRYPT WITH plugin_name [KEY key_name] | DECRYPT}
  | {ENABLE | DISABLE} PUBLICATION
  | INCLUDE {TABLE <table_list> | ALL} TO PUBLICATION
  | EXCLUDE {TABLE <table_list> | ALL} FROM PUBLICATION

<add_sec_clause> ::= ADD <sec_file> [<sec_file> ...]

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

<table_list> ::= tablename [, tablename ...]

Table 1. Paramètres de l’opérateur `ALTER DATABASE`
Paramètre	Description
add_sec_clause	sec_file pour ajouter un fichier de base de données secondaire.
sec_file	Spécifier le fichier secondaire.
filepath	Chemin et nom du fichier delta ou du fichier de base de données secondaire.
pagenum	Le numéro de la page à partir de laquelle le fichier de la base de données secondaire commence.
num	num Taille maximale du fichier secondaire en pages.
diff_file	diff_file chemin et nom du fichier delta.
charset	jeu de caractères par défaut pour la base de données.
linger_duration	délai en secondes.
plugin_name	nom du plugin de cryptage.
key_name	Nom de la clé de cryptage.
table_list	Liste des tableaux à activer ou à désactiver pour lespour la réplication.
tablename	nom de la base de donnée.

L’instruction ALTER DATABASE modifie la structure des fichiers de la base de données ou la fait passer à l’état copy-safe.