Pour amorcer la création d’une nouvelle connexion à une base de données, appuyez sur le bouton Créer dans la page listant les bases de données et suivez les étapes requises.
Identification
Nom
Entrez un nom pour la nouvelle base de données. Le nom choisi doit être unique.
Description
(Optionnel) Entrez une description pour la nouvelle base de données. La description n’est visible que par les administrateurs dans JMap Admin.
Paramètres de connexion
Pilote
Sélectionnez le pilote qui correspond au système de base de données auquel vous voulez vous connecter. Vous pouvez ajouter de nouveaux pilotes en créant de nouveaux fichiers de configuration dans le répertoire JMAP_HOME/conf/db sur le serveur.
Hôte
(Selon le pilote sélectionné) Le nom ou l’adresse TCP/IP du serveur de bases de données.
Port
(Selon le pilote sélectionné) Le port TCP/IP du serveur de bases de données.
Base de données
(Selon le pilote sélectionné) Le nom de la base de données à accéder, tel que défini dans le serveur de bases de données.
Fichier
(Selon le pilote sélectionné) Le chemin d’accès vers le fichier de bases de données.
Chaîne de connexion (Configuration avancée)
(Seulement pour le pilote Oracle) La configuration avancée vous permet de configurer la chaîne de connexion en l’écrivant directement dans la plage spécifique. C’est une manière plus flexible de configurer la chaîne de caractères dans certaines circonstances.
Paramètres supplémentaires
Dans certaines situations exceptionnelles, les systèmes de bases de données peuvent exiger des paramètres supplémentaires. Ils peuvent être entrés dans ce champ.
Nom d’utilisateur
Entrez le nom d’utilisateur pour la connexion à la base de données. L’authentification d’utilisateurs de domaine n’est pas supportée. Vous devez vérifier que la base de données permet l’authentification à ce niveau.
Mot de passe
Entrez le mot de passe pour la connexion à la base de données.
Connexions
Nombre de connexions
Entrez la taille initiale de la réserve de connexions afin de déterminer le nombre de connexions à la base de données qui demeureront ouvertes.
Maximum de connexions
Entrez le nombre maximal de connexions permises pour cette réserve. Le nombre entré doit être égal ou supérieur au nombre initial de connexions. Si la réserve doit s’agrandir, de nouvelles connexions seront automatiquement créées jusqu’à ce que la valeur maximale soit atteinte. Après un certain délai, les connexions supplémentaires sont automatiquement fermées et la réserve reprend sa taille initiale. La valeur maximale peut être désactivée en désélectionnant la case à cocher, afin de permettre d’agrandir la réserve sans contrainte.
En règle générale, les paramètres avancés qui suivent ne doivent pas être modifiés.
Paramètres
Paramètres additionnels
Dans certaines situations exceptionnelles, les systèmes de bases de données peuvent exiger des paramètres additionnels. Ils peuvent être entrés dans ce champ.
Requête de validation
JMap utilise un mécanisme de validation des requêtes afin d’assurer que les connexions à la base de données sont valides. Cette requête est utilisée pour tester la connexion chaque fois qu’une requête doit être exécutée. Si la requête de validation échoue, ce qui signifie généralement que la connexion à la base de données est rompue, JMap Server tentera automatiquement d’établir une nouvelle connexion. Ce mécanisme permet d’assurer que les connexions à la base de données ne cessent jamais de fonctionner. La requête doit être valide et doit s’exécuter très rapidement. Afin de réduire l’impact sur la performance, assurez-vous de minimiser le nombre d’enregistrements retournés (la valeur zéro est idéale) et utilisez des champs indexés dans la clause WHERE. Des requêtes par défaut sont fournies. En règle générale, elles n’ont pas besoin d’être modifiées.
Délai d’expiration de la connexion
Le délai d’inactivité est utilisé pour fermer et ouvrir à nouveau les connexions qui demeurent inactives pendant une période prolongée. Ce mécanisme permet d’assurer que le système de base de données ne ferme pas les connexions inactives. Assurez‑vous que cette valeur est inférieure au délai d’attente de connexion de votre système de base de données. La valeur par défaut de 2 heures convient la plupart du temps.
Délai maximal de connexion
Le délai maximal de connexion définit la valeur du délai d’attente pour les opérations de base de données. Ce paramètre peut être abaissé pour éviter les ralentissements ou les blocages dans les situations où le serveur de base de données met trop de temps à répondre, ou il peut être augmenté pour permettre des périodes d’attente plus longues afin que les requêtes avec un temps de traitement long puissent être exécutées avec succès. La valeur par défaut est de 60 secondes. Activez cette option pour spécifier une valeur différente pour la connexion.
Type de connexion
Indiquez le type de connexion devant être créée. Les connexions génériques utilisent toutes les mêmes informations d’utilisateur (nom d’utilisateur et mot de passe) définies précédemment. Du point de vue du système de base de données, c’est comme si le même utilisateur effectuait toutes les requêtes. Ce type de connexion est utilisé la plupart du temps. Les connexions identifiées sont créées à la volée pour chaque utilisateur connecté à JMap Server. La même connexion est réutilisée au cours de la session pour chaque utilisateur. Du point de vue du système de gestion de bases de données, chaque requête est effectuée par l’utilisateur qui est connecté à JMap Server. Ce mode de connexion est utile dans les environnements où la sécurité est gérée au niveau de la base de données. Afin d’assurer le fonctionnement du mode de connexion identifié, JMap et le système de base de données doivent partager la même liste d’utilisateurs, ce qui peut être le cas lorsque le module de gestion des utilisateurs d’Oracle est utilisé pour gérer les utilisateurs.