4D v16
USE DATABASE
USE DATABASE
|
USE [LOCAL | REMOTE] DATABASE |
||
La commande USE DATABASE vous permet de désigner une base externe 4D comme base de données courante, c’est-à-dire vers laquelle seront dirigées les prochaines requêtes SQL dans le process courant. Tous les types de requêtes SQL sont concernés : requêtes incluses dans une structure Debut SQL/Fin SQL, commandes SQL EXECUTER ou SQL EXECUTER SCRIPT, etc.
Note : Pour plus d'informations sur les bases externes, reportez-vous à la description de la commande CREATE DATABASE.
- Si vous travaillez en configuration monoposte, la base externe doit être située sur votre machine 4D.
- Si vous travaillez en mode distant, la base externe peut être située sur le poste local ou sur la machine 4D Server.
Si vous utilisez 4D en mode distant, le mot-clé REMOTE vous permet de désigner une base externe située sur 4D Server.
Pour des raisons de sécurité, ce mécanisme fonctionne uniquement avec les connexions distantes natives, c’est-à-dire dans le contexte d’une base 4D distante connectée à 4D Server. Les connexions via ODBC ou pass-through ne sont pas autorisées.
Si aucun mot-clé n’est spécifié, l’option LOCAL est utilisée par défaut. Si vous utilisez 4D en mode local, les mot-clés REMOTE et LOCAL sont ignorés : les connexions sont toujours locales.
Pour désigner la base externe à utiliser, passez son chemin complet (chemin d’accès + nom) dans la clause DATAFILE. 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.
En mode distant, si le mot-clé REMOTE est passé, ce paramètre désigne le chemin d’accès de la base à partir du poste serveur. S’il est omis ou si le mot-clé LOCAL est passé, ce paramètre désigne le chemin d’accès de la base sur le poste 4D local.
Important : Vous devez désigner une base 4D externe valide et dans laquelle le système de contrôle des accès n’a pas été activé (via l’attribution d’un mot de passe au Super_Utilisateur). Dans le cas contraire, une erreur est générée.
Pour rétablir la base principale en tant que base courante, exécutez la commande en passant le mot-clé SQL_INTERNAL ou DEFAULT.
Passez AUTO_CLOSE si vous souhaitez fermer physiquement la base externe à l’issue de son utilisation, c’est-à-dire lorsque vous changerez de base courante. En effet, l’ouverture d’une base externe étant une opération qui nécessite du temps, pour des raisons d’optimisation 4D maintient en mémoire des informations relatives aux bases externes ouvertes durant la session utilisateur. Ces informations sont maintenues en mémoire tant que l’application 4D est lancée. Les réouvertures suivantes d’une même base externe sont alors accélérées. Toutefois, ce principe empêche le partage des bases externes entre plusieurs applications 4D car la base externe reste ouverte en lecture/écriture pour la première application qui l’a utilisée. Si plusieurs applications 4D doivent pouvoir utiliser simultanément une même base externe, passez le mot-clé AUTO_CLOSE afin de libérer physiquement la base externe après son utilisation.
Cette restriction ne s’applique pas aux process d’une même application : différents process d’une application peuvent toujours accéder à une même base externe en lecture/écriture sans qu’il soit nécessaire de forcer sa fermeture.
A noter que lorsque plusieurs process utilisent la même base externe, elle n’est libérée physiquement que lorsque le dernier process qui l’utilise est refermé, même lorsque l’option AUTO_CLOSE a été passée. Vous devez tenir compte de ce fonctionnement pour les opérations de partage inter-applications et de suppression des bases externes.
Utilisation d’une base externe pour une requête puis retour à la base principale :
Debut SQL
USE DATABASE DATAFILE 'C:/MaBase/Noms'
SELECT Name FROM emp INTO :tNoms1
USE DATABASE SQL_INTERNAL
Fin SQL
Produit : 4D
Thème : Commandes SQL
Nom intl. : USE DATABASE
4D - Référence SQL ( 4D v16)
