4D Doc Center : CREATE DATABASE

4D v14

CREATE DATABASE



	CREATE DATABASE [IF NOT EXISTS] DATAFILE <Chemin d’accès complet>

Description

La commande CREATE DATABASE vous permet de créer une nouvelle base de données externe (fichiers standard .4db et .4dd) à un emplacement spécifique.

Si la contrainte IF NOT EXISTS est passée, la base de données n’est pas créée et aucune erreur n’est générée si une base du même nom existe déjà à l’emplacement défini.
Si la contrainte IF NOT EXISTS n’est pas passée, la base de données n’est pas créée et le message d’erreur "Cette base de données existe déjà. Echec de la commande CREATE DATABASE" est affiché si une base du même nom existe déjà à l’emplacement défini.

La clause DATAFILE vous permet de définir le nom complet (chemin d’accès complet + nom) de la nouvelle base de données externe. Vous devez passer le nom du fichier de structure. Le programme ajoute automatiquement l’extension ".4db" au fichier si elle n’est pas déjà définie et crée le fichier de données. Le chemin d’accès peut être exprimé soit en syntaxe POSIX, soit en syntaxe système. Il peut être absolu ou relatif au fichier de structure de la base 4D principale.

syntaxe POSIX (type URL) : les noms de dossiers sont séparés par une barre oblique ("/"), quelle que soit la plate-forme que vous utilisez, par exemple : "../basesexternes/mabase.4db"
Pour un chemin absolu, vous devez passer le nom du volume suivi de deux-points, par exemple : "C:/test/basesexternes/mabase.4db"
syntaxe système : chemin d'accès respectant la syntaxe de la plate-forme courante, par exemple :
- (Mac OS) Disque:Applications:monserv:basesexternes:mabase.4db
- (Windows) C:\Applications\monserv\basesexternes\mabase.4db

Après l’exécution réussie de la commande CREATE DATABASE, la nouvelle base de données créée ne devient pas automatiquement la base courante. Pour cela, vous devez explicitement la déclarer en tant que base courante à l’aide de la commande USE DATABASE.

A propos des bases externes

Une base externe est une base 4D indépendante de la base 4D principale, mais que vous pouvez utiliser et manipuler depuis la base 4D principale, en utilisant le moteur SQL de 4D. Utiliser une base externe signifie désigner temporairement cette base comme base courante, c’est-à-dire comme base cible des requêtes SQL exécutées par 4D. Par défaut, la base courante est la base principale.

Vous pouvez créer autant de bases externes que vous voulez depuis la base 4D principale avec la commande CREATE DATABASE. Une fois créée, une base externe peut être désignée comme base courante à l’aide de la commande USE DATABASE. Elle peut alors être modifiée via les commandes SQL standard (CREATE TABLE, ALTER TABLE, etc.) et vous pouvez y stocker des données. La fonction DATABASE_PATH permet de connaître à tout moment la base courante.
L’intérêt majeur des bases externes réside dans le fait qu’elles peuvent être créées et manipulées via des composants 4D. Ce principe permet de développer des composants pouvant créer des tables et des champs en fonction de leurs besoins.

Note : Une base externe est une base 4D standard. Elle peut être ouverte et manipulée en tant que base principale par une application 4D ou 4D Server. Inversement, toute base 4D standard peut être utilisée comme base externe. Toutefois, il est impératif de ne pas activer le système de gestion des accès (via l’affectation d’un mot de passe au Super_Utilisateur) dans une base externe sinon elle ne sera plus accessible via la commande USE DATABASE.

Exemple 1

Création des fichiers de base externe ExternalDB.4DB et ExternalDB.4DD à l’emplacement C:/MaBase/ :

 Debut SQL

    CREATE DATABASE IF NOT EXISTS DATAFILE 'C:/MaBase/ExternalDB';

 Fin SQL

Exemple 2

Création des fichiers de base externe TestDB.4DB et TestDB.4DD à côté du fichier de structure de la base principale :

 Debut SQL

    CREATE DATABASE IF NOT EXISTS DATAFILE 'TestDB';

 Fin SQL

Exemple 3

Création des fichiers de base externe External.4DB et External.4DD à l’emplacement défini par l’utilisateur :

 C_TEXTE($chemin)

 $chemin:=Selectionner dossier("Dossier de destination de la base externe :")

 $chemin:=$chemin+"External"

 Debut SQL

    CREATE DATABASE DATAFILE <<$chemin>>;

 Fin SQL