4D Doc Center : USE DATABASE

4D v14

USE DATABASE



	USE [LOCAL \| REMOTE] DATABASE {DATAFILE <Ruta de acceso completa> \| SQL_INTERNAL \| DEFAULT} [AUTO_CLOSE]

Descripción

El comando USE DATABASE se utiliza para designar una base externa como base de datos actual, en otras palabras, la base a la cual se dirigirán las próximas consultas SQL en el proceso actual. Todos los tipos de consultas SQL concernientes: consultas incluidas en la estructura Begin SQL/End SQL, comandos SQL EXECUTE o EXECUTE SCRIPT, etc.

Nota: para mayor información sobre bases externas, consulte la descripción del comando CREATE DATABASE.

Si trabaja en una configuración monopuesto, la base externa debe estar ubicada en la misma máquina que su 4D.
Si trabaja en modo remoto, la base externa puede estar ubicada en la máquina local o en la máquina 4D Server.

Si utiliza 4D en modo remoto, la palabra clave REMOTE permite designar una base externa ubicada en 4D Server.

Por razones de seguridad, este mecanismo sólo funciona con conexiones remotas nativas, es decir, en el contexto de una base 4D remota conectada a 4D Server. Las conexiones vía ODBC o pass-through no están permitidas.
Si no se especifica la palabra clave, la opción LOCAL se utiliza por defecto. Si está utilizando 4D en modo local, las palabras claves REMOTE y LOCAL se ignoran: las conexiones son siempre locales.

Para designar una base externa a utilizar, pase su ruta completa (ruta de acceso + nombre) en la cláusula DATAFILE. La ruta puede expresarse en la sintaxis POSIX o en la sintaxis del sistema. Puede ser absoluta o relativa al archivo de estructura de la base 4D principal.

En modo remoto, si se pasa la palabra clave REMOTE, este parámetro designa la ruta de acceso de la base a partir de la máquina servidor. Si se omite o si se pasa la palabra clave LOCAL, este parámetro designa la ruta de acceso de la base en la máquina 4D local.

Importante: debe designar una base 4D externa válida y en la cual el sistema de control de acceso no esté activado (mediante la asignación de una contraseña al Diseñador). De lo contrario, se genera un error.

Con el fin de restablecer la base principal como la base actual, ejecute el comando al pasar la palabra clave SQL_INTERNAL o DEFAULT.

Pase AUTO_CLOSE si desea cerrar físicamente la base externa después de su uso, es decir, cuando usted cambia la base actual. De hecho, la apertura de una base externa es una operación que requiere un poco de tiempo, por razones de optimización 4D mantiene en la memoria la información relativa a las bases externas abiertas durante la sesión usuario. Esta información se mantiene en memoria hasta que se lance la aplicación 4D. Las aperturas posteriores de la misma base externa, son por lo tanto más rápidas. Sin embargo, esto impide el intercambio de bases externas entre varias aplicaciones 4D porque la base de datos externa sigue estando abierta en lectura/escritura para la primera aplicación que la utilice. Si varias aplicaciones 4D deben utilizar la misma base externa al mismo tiempo, pase la palabra clave AUTO_CLOSE para liberar físicamente la base externa después de su uso.

Esta restricción no aplica a los procesos de la misma aplicación: diferentes procesos de una aplicación siempre pueden acceder a la misma base externa en lectura/escritura sin que sea necesario forzar su cierre.
Tenga en cuenta que cuando varios procesos utilizan la misma base externa, es físicamente liberada sólo hasta que el último proceso que utiliza se cierre, incluso cuando se pasa la opción AUTO_CLOSE. Debe tener en cuenta este funcionamiento para las operaciones que implican el intercambio entre aplicaciones o supresión de bases externas.

Ejemplo

Uso de una base externa para una búsqueda luego regresa a la base principal:

 Begin SQL

    USE DATABASE DATAFILE 'C:/MiBase/Noms'

    SELECT Name FROM emp INTO :tNoms1

    USE DATABASE SQL_INTERNAL

 End SQL