4D Doc Center : CREATE DATABASE

4D v14

CREATE DATABASE



	CREATE DATABASE [IF NOT EXISTS] DATAFILE <Ruta de acceso completa>

Descripción

El comando CREATE DATABASE le permite crear una nueva base de datos externa (archivos db .4db y .4dd) en una ubicación específica.

Si se pasa la restricción IF NOT EXISTS, la base de datos no se crea y ningún error se genera si una base con el mismo nombre ya existe en la ubicación especificada.
Si no se pasa la restricción IF NOT EXISTS, la base de datos no se crea y se muestra el mensaje de error "Esta base de datos ya existe. No se pudo ejecutar el comando CREATE DATABASE." si una base de datos con el mismo nombre ya existe en la ubicación especificada.

La cláusula DATAFILE permite especificar el nombre completo (ruta de acceso completa + nombre) de la nueva base de datos externa. Debe pasar el nombre del archivo de estructura. El programa añadirá automáticamente la extensión ".4db" al archivo si no está y crea el archivo de datos. La ruta puede expresarse en sintaxis POSIX o en la sintaxis del sistema, puede ser absoluta o relativa al archivo de estructura de la base 4D principal.

Sintaxis POSIX (tipo URL): los nombres de las carpetas están separados por una barra oblicua ("/"), independientemente de la plataforma que utilice, por ejemplo: .../extdatabases/myDB.4db
Para una ruta absoluta, pase en la primera posición el nombre del volumen seguido de dos puntos, por ejemplo: "C:/test/extdatabases/myDB.4db"

Sintaxis sistema: ruta de acceso respetando la sintaxis de la plataforma actual, por ejemplo:
- (Mac OS) Unidad:Applications:miserv:basesexternas:mibase.4db
- (Windows) C:ApplicationsmyservextdatabasesmyDB.4db

Después de la ejecución exitosa del comando CREATE DATABASE, la nueva base de datos creada no se convierte automáticamente en la base actual. Para hacer esto, debe declararla explícitamente como la base actual con el comando USE DATABASE.

Sobre las bases externas

Una base externa es una base 4D independiente de la base 4D principal, pero con la que puede trabajar desde la base 4D principal utilizando el motor SQL de 4D. Usar una base externa significa designar temporalmente esta base como base actual, es decir, como la base de objetivo de las consultas SQL ejecutadas por 4D. Por defecto, la base actual es la base principal.

Puede crear una base de datos externa directamente desde la base principal con el comando CREATE DATABASE. Una vez creada, una base externa puede ser designada como la base actual con el comando USE DATABASE. A continuación, se puede modificar a través de comandos estándar SQL (CREATE TABLE, ALTER TABLE, etc.) y puede almacenar datos en ella. La función DATABASE_PATH permite conocer la base de datos actual en cualquier momento.
El interés principal de las bases externas reside en el hecho de que pueden ser creadas y manipuladas vía componentes 4D. Esto permite el desarrollo de componentes que son capaces de crear tablas y campos de acuerdo a sus necesidades.

Nota: una base externa es una base 4D estándar. Se puede abrir y manipular como la base principal mediante una aplicación 4D o 4D Server. Por el contrario, toda base 4D estándar se puede utilizar como base externa. Sin embargo, es imperativo que no active el sistema de gestión de acceso (mediante la asignación de una contraseña al Diseñador) en una base externa, de lo contrario ya no podrá tener acceso a ella a través del comando USE DATABASE.

Ejemplo 1

Creación de archivos de base externa ExternalDB.4DB y ExternalDB.4DD en C:/MiBase/:

 Begin SQL

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

 End SQL

Ejemplo 2

Creación de archivos de base externa TestDB.4DB y TestDB.4DD junto al archivo de estructura de la base principal:

 Begin SQL

    CREATE DATABASE IF NOT EXISTS DATAFILE 'TestDB';

 End SQL

Ejemplo 3

Creación de los archivos de base externa External.4DB y External.4DD en la ubicación definida por el usuario:

 C_TEXT($path)

 $path:=Select folder("Carpeta de destino de la base externa:")

 $path:=$path+"External"

 Begin SQL

    CREATE DATABASE DATAFILE <<$path>>;

 End SQL