Création ou édition d'un noeud final d'activité de base de données

Les noeuds finaux fournissent les informations de connexion de base de données utilisées par Studio et le dispositif d'intégration pour se connecter à une base de données.

Sélectionner ou éditer un noeud final de base de données

  1. Dans le panneau Créer un noeud final ou Editer un noeud final, configurez les zones comme décrit dans les tableaux suivants.
    Remarque : La modification des propriétés de configuration d'un noeud final affecte toutes les orchestrations qui utilisent ce noeud final dans le projet. Les éditions sont globales et non pas locales.
  2. Cliquez sur Tester la connexion pour confirmer que vous pouvez vous connecter à la base de données. Cliquez sur OK.

Options de base de données

Tableau 1. Options de base de données
Zone Description
Type de base de données Spécifie le type de base de données. Si vous sélectionnez le pilote JDBC générique ou MySQL, vous devez installer les fournisseurs de module dans Studio. Pour ajouter des pilotes JDBC dans Studio, ajoutez-les à la console de gestion Web puis exécutez les étapes suivantes dans cette même console.
  1. Accédez à Settings.
  2. Sélectionnez Design.
  3. Sélectionnez Libraries Environment et spécifiez comme valeur l'environnement dans lequel vous avez chargé les fichiers compressés.
  4. Redémarrez Studio.
Remarque : Pour que les pilotes JDBC puissent accéder aux noeuds finaux pour Cast Iron Generic JDBC, le pilote JDBC doit avoir les caractéristiques suivantes :
  • Il doit être de type 4.
  • Il doit permettre d'implémenter la spécification JDBC 2.0 ou supérieure.
  • Il doit prendre en charge l'interface (API) de source de données.
D'autres paramètres peuvent être requis pour les pilotes JDBC génériques. Consultez la documentation du pilote que vous souhaitez utiliser pour savoir si d'autres paramètres sont requis.
Pour plus d'informations sur l'installation des bibliothèques JNBC dans la console de gestion Web, voir l'aide en ligne de la console WMC.
Nom de la base de données Spécifie le nom de la base de données à laquelle vous souhaitez vous connecter. Si vous vous connectez à Oracle RAC, voir Pour Oracle RAC :.
Remarque : Pour les bases de données AS/400 et DB2, il s'agit du nom de collection défini pendant l'installation.
Emplacement réseau : Serveur Spécifie le nom ou l'adresse IP de la machine où se trouve le serveur de base de données. Pour Informix, connectez-vous à Informix Server Administrator et sélectionnez l'option de menu Configuration > SQLHOST pour trouver le nom d'hôte. Pour Sequelink, entrez le nom d'hôte ou l'adresse IP du serveur Sequelink.
Emplacement réseau : Port Spécifie le numéro de port de l'écouteur (listener) du serveur de base de données. Pour Sequelink, entrez le numéro de port de l'écouteur (listener) du serveur Sequelink.
Nom d'utilisateur Spécifie le nom d'utilisateur que le dispositif d'intégration utilise pour se connecter à la base de données.
Remarque : L'utilisateur DB2 doit avoir l'autorisation de créer un package.
Mot de passe Spécifie le mot de passe associé au nom d'utilisateur indiqué.
Paramètres supplémentaires Spécifie les informations spécifiques de la base de données pour un noeud final. Voir Utilisation des paramètres de base de données pour plus de détails. Par défaut, le paramètre MaxPooledStatements est automatiquement défini et paramétré avec une valeur par défaut pour tous les types de noeuds finaux de base de données.
Remarque : Pour certaines zones du noeud final, vous pouvez définir des propriétés de configuration pour fournir les valeurs de ces zones.L'icône
apparaît lorsque vous cliquez dans une zone qui prend en charge une propriété de configuration et qu'une propriété de configuration du même type a déjà été configurée pour le projet.

Pour les bases de données Informix

Pour rechercher le numéro de port d'une base de données Informix :
  1. Dans un éditeur, ouvrez le fichier suivant :$INFORMIXSERVER/etc/sqlhosts
  2. Notez le nom servicename dans la colonne SERVER.
  3. Dans un éditeur, ouvrez le fichier approprié à votre système :
    • UNIX - /etc/services  
    • Windows - \Winnt\system32\drivers\etc\services
  4. Dans le fichier, recherchez le nom servicename pour trouver le numéro de port associé.

Pour les bases de données DB2 AS/400

Pour certaines colonnes EBCDIC-US sur DB2 AS/400, Studio ne peut pas déterminer la taille et le type corrects.
Pour transmettre un paramètre codé EBCDIC-US :
  1. Dans Studio, ouvrez l'orchestration contenant une activité de connecteur de base de données.
  2. Modifiez les colonnes de type CHAR en type VARBINARY. Les colonnes codées EBCDIC apparaissent en tant que colonnes de type CHAR dans le type de données du connecteur sortant.
  3. Utilisez une mappe avant le connecteur de base de données afin de remplir un paramètre codé EBCDIC avec des espaces, de sorte que la valeur du paramètre égale la longueur de la colonne.

    Par exemple, si la longueur de la colonne est 10 et la valeur est "abc", insérez 7 espaces dans la colonne.

    Si la valeur codée EBCDIC n'est pas complétée par des espaces, le connecteur de base de données remplit la valeur avec des valeurs NULL. Cela peut entraîner des données incohérentes et des erreurs peuvent se produire.

Pour lire une colonne codée EBCDIC-US à partir d'un ensemble de résultats :
  1. Dans Studio, ouvrez l'orchestration contenant l'opération de requête paramétrée de connecteur de base de données.

    Lorsque vous utilisez une requête paramétrée pour sélectionner une colonne codée EBCDIC dans une base de données, le connecteur de base de données renvoie des valeurs complétées par des espaces si la valeur est inférieure à la longueur de la colonne.

    Par exemple, si la longueur de la colonne est 10 et la valeur est "abc", le connecteur de base de données insère 7 espaces dans la colonne.

  2. Créez une mappe après l'opération Requête paramétrée pour supprimer les espaces insérés dans l'ensemble de résultats XML.

Pour Oracle RAC :

IBM Cast Iron prend en charge les propriétés supplémentaires dans la chaîne de connexion qui activent la connectivité Oracle RAC. Utilisez les propriétés supplémentaires suivantes pour vous connecter à Oracle RAC :
  1. AlternateServers=(nomserveur1[:port1]
    [;property=valeur[;...]],
    nomserveur2[:port2]
    [;property=value[;...]],...) 

    Où :

    nomserveur représente l'adresse IP du serveur

    port est le numéro de port du serveur

    property=valeur entrez le nom de service utilisé en tant que nom de base de données. La saisie d'un SID est facultative.

  2. LoadBalancing=true|false

    Détermine si le pilote utilise l'équilibrage de charge du client dans sa tentative de se connecter à une liste de serveurs de base de données, principaux et secondaires. La liste de serveurs secondaires est spécifiée par la propriété AlternateServers. Si cette propriété est définie par true, l'équilibrage de charge du client est utilisé et le pilote tente de se connecter à la liste des serveurs de base de données, principaux et secondaires, aléatoirement. Si cette propriété est définie par false (valeur par défaut), l'équilibrage de charge du client n'est pas utilisé et le pilote se connecte à chaque serveur en fonction de leur ordre séquentiel (en commençant par le serveur principal et en poursuivant avec les serveurs secondaires, dans l'ordre où ils sont indiqués).

  3. Utilisez le nom de service dans le Nom de base de données du noeud final.

Options de pool de connexions, de codage, de délai d'attente et de sécurité

Des valeurs par défaut sont fournies pour les options de pool de connexion. Vous pouvez les modifier à votre convenance.
Tableau 2.
Zone Description
Options de pool de connexions  
Taille de pool initiale Indique le nombre initial de connexions de base de données que le dispositif d'intégration ouvre et place dans le pool de connexions.
Nombre minimal de connexions Indique le nombre minimal de connexions de base de données que le dispositif d'intégration garde ouvertes dans le pool de connexions. La valeur 0 est prise en charge.
Nombre maximal de connexions Indique le nombre maximal de connexions de base de données que le dispositif d'intégration peut garder ouvertes dans le pool de connexions. La valeur 0 signifie que le nombre de connexions est illimité.
Temps d'inactivité maximal Spécifie la durée en minutes pendant laquelle une connexion de base de données peut être ouverte et inactive avant d'être fermée par le dispositif d'intégration. La valeur 0 signifie que les connexions sont fermées lorsqu'elles sont renvoyées vers le pool - pas de délai d'inactivité.
Récupérer les connexions Spécifie la fréquence à laquelle le dispositif d'intégration vérifie le pool de connexions pour déterminer si des connexions doivent être fermées. Par exemple, si le paramètre Récupérer les connexions est défini sur 6 minutes, le dispositif d'intégration vérifie le pool de connexions toutes les six minutes pour déterminer si le nombre total de connexions ouvertes dans le pool est supérieur au nombre minimal de connexions. Si le nombre de connexions ouvertes est supérieur au nombre minimal spécifié, le dispositif d'intégration ferme les connexions en surnombre (dépassant le Nombre minimal de connexions) qui ont excédé le Temps d'inactivité maximal.

Par exemple, le Nombre minimal de connexions est défini sur 2, le Nombre maximal de connexions est défini à 6, le paramètre Récupérer les connexions est défini à 6 minutes et le Temps d'inactivité maximal a pour valeur 2 minutes. Un total de cinq connexions sont ouvertes dans le pool de connexions. Lorsque le délai de 6 minutes pour Récupérer les connexions est atteint, le dispositif d'intégration vérifie le pool de connexions et détermine qu'une connexion a été inactive pendant 3 minutes, une connexion a été inactive pendant 4 minutes et trois connexions sont encore actives. Le dispositif d'intégration ferme les deux connexions inactives. Après 6 minutes supplémentaires, le dispositif d'intégration vérifie le pool de connexions à nouveau.

Codage par défaut  
Codage Spécifie le codage de caractères par défaut à utiliser lors de la connexion à cette base de données. Pour définir le type de codage sélectionnez l'une des options suivantes :
  • Dans la liste déroulante Codage, sélectionnez un type de codage par défaut.
  • Entrez le type de codage directement en cliquant dans la zone Codage et en saisissant le type de codage.
Remarque : Certains caractères codés sur deux octets ne sont pas convertis à l'aide du codage SHIFT-JIS. Pour plus d'informations, voir Utilisation du codage Shift-JIS.
Identificateurs délimités  
Délimiter les identificateurs pour les tables, les colonnes et les objets avec des apostrophes Spécifie si des apostrophes sont utilisées autour des identificateurs pour les tables, les colonnes et les objets de base de données dans les instructions SQL générées que le dispositif d'intégration et Studio utilisent pour communiquer avec la base de données. La mise entre apostrophes d'un identificateur rend ce dernier sensible à la casse. Par exemple, la chaîne d'identificateur : myTable peut faire référence à la table nommée mytable ou MYTABLE mais la chaîne d'identificateur avec apostrophes, "myTable", fait uniquement référence à une table nommée myTable. La mise entre apostrophes d'un identificateur permet également d'utiliser des caractères ne figurant généralement pas dans les noms de base de données, par exemple les espaces.
Sécurité  
Activer le chiffrement Spécifie que la connexion doit utiliser SSL.
Valider le certificat du serveur Spécifie que le client doit valider le certificat de serveur de base de données. Voir Test d'une connexion SSL à une base de données.
Exiger l'authentification de client Spécifie que le client présente un certificat au serveur de base de données.
Délai de connexion  
Dépassement de délai après ___ seconde(s) lors de l'établissement d'une connexion avec le noeud final. Spécifie la durée en secondes avant l'expiration du délai entre la tentative du dispositif d'intégration pour établir une connexion avec le noeud final et le temps nécessaire au noeud final pour répondre à la demande de connexion. Pour une activité de base de données, durée pendant laquelle le dispositif d'intégration tente d'établir une connexion avec le serveur de base de données avant l'expiration du délai. Un délai de connexion est différent d'un délai d'activité car l'expiration du délai d'une activité se produit après que la connexion avec le noeud final a été établie. Un délai d'activité spécifie la durée en secondes avant l'expiration du délai entre l'activité appelant une demande sur un noeud final et le temps nécessaire au noeud final pour répondre. Vous définissez le délai d'expiration de l'activité dans la tâche Réessayer des activités de base de données suivantes :