1.0 Introduction
2.0 Spécifications et logiciels pris en charge
3.0 Restrictions
3.1 Connexion nécessaire pour la génération de bean Java ou de méthode d'EJB à partir d'une procédure mémorisée
4.0 Problèmes connus
4.1 Modèles de base
de données
4.2 Requêtes SQL
4.3 Connexions
aux bases de données
4.4 DDL SQL
4.5 Génération de
rapports d'erreurs
4.6 L'exécution d'instructions sql crée des tables incorrectes dans Oracle
4.7 Exportation de
données
4.8 Edition de procédures mémorisées Java
4.9 Modifications perdues lors de la fermeture de l'éditeur du document en lecture seule
4.10 Guillemets manquantes pour les paramètres nationaux non anglais des identificateurs d'objet
4.11 Connexion à un serveur DB2
4.12 Retrait
des procédures mémorisées Java de DB2 version 8 non pris en charge lors de l'utilisation d'un client DB2 version 7
4.13 Modification manuelle des
types de données SQL renvoyés pour les fonctions définies par l'utilisateur des tables DB2
4.14 Erreur lors de la génération ou de l'exécution d'une routine DB2 - Gestion de la connexion non valide ou connexion fermée
4.15 Problèmes rencontrés avec Sequelink 5.1 livré avec WebSphere Studio
4.16 Pilote DataDirect Sequelink 5.3
4.17 Le contenu de l'assistant de connexion n'est pas visible
4.18 Problèmes lors de l'extraction des tables de Microsoft SQL Server
4.19 Problèmes lors de la connexion à Cloudscape 5.1
4.20 Noeuds de schéma en double lors de l'importation, la suppression ou la nouvelle importation de fichiers JAR d'EJB
4.21 Messages d'erreur en arabe corrompus lors d'exportation de données relationnelles
4.22
Assistant de création de procédure mémorisée : La sélection du bouton d'option
relatif aux instructions SQL provoque l'arrêt de l'assistant
Les outils de base de données relationnelle de WebSphere Studio permettent de se connecter à des bases de données, d'afficher ou d'importer des modèles de base de données, de créer des bases de données à l'aide d'assistants, d'exporter de nouveaux modèles dans une base de données, de créer et d'exécuter des requêtes SQL à l'aide de SQL Builder et de créer et d'exécuter des procédures mémorisées DB2, ainsi que des fonctions DB2 définies par l'utilisateur. Les outils de bases de données relationnelles sont accessibles à partir de la perspective Données et des vues Définition de données et Serveurs de base de données.
Les outils de bases de données relationnelles prennent en charge la connexion et l'importation des types de base de données suivants :
- SQL 92, 99
- Cloudscape 5.0.4
- DB2 UDB 6.1, 7.1, 7.2, 8.1
- DB2 UDB pour iSeries 4.5, 5.1
- DB2 UDB pour OS/390 6, 7
- DB2 UDB Express Edition 8.1
- Oracle 8i 8.1.7
- Oracle 9i 9.0.1
- SQL Server Enterprise 7.0 SP2
- SQL Server Enterprise 2000
- Sybase Adaptive Server Enterprise 11.9.2, 12, 12.5
- Informix Dynamic Server.2000 9.2
- Informix Dynamic Server 7.3, 9.3, 9.3.1
- MySQL 3.23
- InstantDB 3.26
La prise en charge de SQL dans l'assistant SQL et le générateur de requête SQL dépend du niveau de prise en charge offert par le fournisseur de la base de données.
Prise en charge de la sélection complète :
Prise en charge des jointures :
- Applicable pour DB2, Oracle, Cloudscape et Sybase uniquement.
- En ce qui concerne DB2, les opérateurs Union, Union All, Except, Except All, Intersect et Intersect All, ainsi que les clauses values, ne sont pas pris en charge.
- En ce qui concerne Oracle, les opérateurs Union, Union All, MINUS et Intersect sont pris en charge.
- En ce qui concerne Sybase, les opérateurs Union et Union All sont pris en charge.
- En ce qui concerne Cloudscape, les opérateurs Union, Union All, ainsi que les clauses values sont pris en charge.
Prise en charge des résultats des requêtes de regroupement :
- DB2 : jointure interne, jointure externe gauche, jointure externe droite, jointure externe complète.
- Oracle : jointure interne, jointure externe gauche et jointure externe droite. La syntaxe des jointures externes gauche et droite correspond à la syntaxe Oracle "+" de la clause where.
- Sybase, Cloudscape et MySQL : jointure interne, jointure externe gauche et jointure externe droite.
Prise en charge de l'expression cast :
- DB2 : Group By, Rollup, Cube et Grouping Sets
- Oracle : Group By, Rollup et Cube.
- Sybase : Group By.
- Cloudscape : Group By
- DB2 - CAST expression AS expression
- MS SQL Server - CAST expression AS data_type
- Oracle - TRANSLATE n'est pas pris en charge.
Sous Linux, un arrêt système peut se produire lors de la connexion à DB2 Universal Database for iSeries V5R1 à l'aide du pilote JDBC AS/400 Toolbox for Java. Le problème se produit lorsque vous entrez un mot de passe incorrect ou que vous laissez la zone du mot de passe vide. Lorsque cette erreur se produit, redémarrez le produit et connectez-vous à nouveau en utilisant le mot de passe correct.
Pour pouvoir utiliser les assistant qui permettent la génération d'un bean Java ou d'une méthode d'EJB, vous devez travailler en ligne.
- La modélisation des index, contraintes uniques et de contrôle, déclencheurs, types structurés ou colonnes d'identité n'est pas prise en charge actuellement.
- Les outils des données relationnelles ne prennent pas en charge les options de vérifications sur les vues.
- Des crochets insérés inutilement dans les instructions de requête génèrent des erreurs dans l'analyseur (ou l'interpréteur).
- L'utilisation de parenthèses dans les clauses conditionnelles WHERE des requêtes n'est actuellement pas prise en charge.
- Les fichiers SQL de grande taille sont susceptibles de réduire les performances de l'éditeur.
- Pour Oracle, les instructions de mise à jour doivent affecter des valeurs aux colonnes individuellement, sans indiquer de groupes entre parenthèses. Ajoutez des colonnes individuellement et, pour ajouter une valeur avec une sous-requête, utilisez l'option "Créer une expression" dans la zone de liste des cellules de table Valeur pour créer une expression de requête pour la colonne.
- Les modifications apportées aux objets de base de données utilisés par une instruction peuvent entraîner l'échec de SQL Builder car ce dernier ne peut plus analyser correctement la syntaxe de l'instruction par rapport au modèle de données local.
- L'édition d'une vue, puis l'ouverture d'une instruction contenant cette même vue, peut provoquer un arrêt inattendu du plan de travail.
- Si une connexion à une base de données est imposée en dehors de WebSphere Studio, elle n'apparaîtra pas dans l'exécution de l'instruction. Réimportez la base de données vers le projet à partir de la vue Serveurs de base de données pour restaurer la connexion.
- Une requête ne peut pas être créée à l'aide d'une vue dérivée d'une fonction définie par l'utilisateur.
- Le déplacement par glissement des objets de base de données est pris en charge dans la vue Définition de données, mais pas dans la vue Serveurs de base de données.
- Si vous importez une table DB2 UDB ou DB2 for iSeries contenant une colonne de type DATALINK, les options de contrôle des liens correspondant à cette colonne ne sont pas importées. La valeur de longueur par défaut de la colonne DATALINK est 200 et les options de lien ont par défaut la valeur NO LINK CONTROL. Vous pouvez mettre à jour ces propriétés dans l'éditeur de table après avoir importé la table dans la vue des données.
- La suppression de plusieurs connexions dans la vue Serveurs de base de données ne fonctionne pas toujours. Si vous rencontrez un tel problème, vous pouvez conserver vos connexions ou les supprimer une à une.
- Les chaînes de caractères peuvent ne pas être importées correctement pour les connexions aux serveurs iSeries. Les types de données CHAR FOR BIT DATA, VARCHAR FOR BIT DATA et LONG VARCHAR FOR BIT DATA peuvent être importés sans les options FOR BIT DATA. Dans ces cas, utilisez l'éditeur de tables dans la perspective Données pour éditer les colonnes affectées.
- Les noms d'objets de schémas qui contiennent des caractères DBCS peuvent ne pas être importés correctement à partir d'iSeries. Les guillemets peuvent être manquantes dans les identificateurs délimités. Dans ces cas, utilisez l'éditeur de tables pour éditer les noms de colonne et de contrainte.
- Les identifiants des contraintes de clé principale ne sont pas importés pour les connexions OS/390.
- Les valeurs de colonne par défaut qui correspondent à des procédures mémorisées, des fonctions, ou qui sont définies avec une clause d'identité ne sont pas importées correctement et peuvent se traduire par des caractères non Ascii dans un document de table. Ces caractères provoquent des erreurs lors du chargement du document. Lorsque cela se produit, il est nécessaire d'éditer manuellement le document tblxmi à l'origine de l'erreur et de supprimer la balise et la valeur par défaut.
- Lorsque vous utilisez le pilote JDBC WebSphere Connect pour les connexions à une base de données de serveur SQL, vous avez généralement besoin de trois fichiers jar pour spécifier l'emplacement des classes. Il est recommandé de regrouper ces fichiers jar en un seul. Dans le cas contraire, lorsque l'assistant est rouvert après avoir établi une connexion, sa taille est anormalement grande. Cette situation est due à la longueur de la zone de l'emplacement du pilote .
- Lors de la création d'une connexion à une base de données à partir d'un client DB2 Version 8, si vous voulez utiliser le pilote IBM DB2 NET DRIVER JDBC, vous devez ajouter ces deux fichiers JAR à la zone de l'emplacement de la classe : <REPDB2>/java/db2jcc.jar et <REPDB2>/java/common.jar (où <REPDB2> correspond au répertoire dans lequel vous avez installé DB2). Si vous n'effectuez pas cette action, vous obtenez une erreur. Remarque Si vous utilisez l'assistant Nouvelle connexion à une base de données sans ajouter ces fichiers JAR à l'emplacement de la classe, les procédures mémorisées ne seront pas chargées. Vous devez utiliser l'assistant de connexion pour entrer les fichiers dans la zone de l'emplacement de la classe .
- Les méta-données de table et de schéma ne peuvent pas être importées lors de l'utilisation d'un client DB2 UDB Version 8 pour établir une connexion à la version 7 ou à une version antérieure de DB2 sur z/OS. Pour résoudre le problème, installez la PTF UQ72081 de DB2 pour z/OS.
- Des incidents risquent de se produire lors de l'importation ou de la modification de données Oracle de type long.
- Les fichiers DLL SQL de très grande taille sont susceptibles de réduire les performances de l'éditeur.
- Ils peuvent générer des exceptions de type mémoire saturée au cours de l'analyse ou de l'exécution.
- L'édition de scripts Oracle peut générer des erreurs dans la vue Structure de l'éditeur. Par exemple, les instructions "CREATE SEQUENCE", "CREATE OR REPLACE TRIGGER" et "END" s'affichent comme étant incorrectes. Toutefois, vous pouvez toujours exporter ces éléments sur un serveur Oracle.
Une erreur risque de se produire lors de l'analyse d'un fichier SQL. Le symbole situé après le symbole désigné par le message d'erreur en est la cause. Le message d'erreur est également affiché dans la liste des tâches.
Lorsqu'un fichier sql est exécuté sur le serveur de base de données Oracle, il est nécessaire tout d'abord de créer les séquences et les déclencheurs de table. Cette situation est due au fait que WebSphere entre en interaction avec Oracle de manière incorrecte en insérant des espaces supplémentaires. Une fois les tables créées, à partir de la machine serveur Oracle, éditez l'instruction afin de supprimer les espaces insérés et d'ajouter la commande 'end;'. Puis à partir de WebSphere, exécutez à nouveau l'instruction SQL sur le serveur en sélectionnant cette fois les instructions alter et insert.
- Vous ne pouvez copier des artefacts existants dans le catalogue/la base de données d'arrière-plan qu'en exécutant l'option Exécuter sur le serveur sur les scripts DDL SQL. Pour copier les objets existants dans des objets de données (bases de données, schémas, tables), vous devez sélectionner l'option Générer un fichier DDL dans le menu en incrustation, en spécifiant la copie des instructions existantes. Dans le script DLL SQL généré, sélectionnez l'option Exécuter sur le serveur dans le menu en incrustation. Si les objets n'existent pas dans le catalogue/la base de données d'arrière-plan, il suffit de choisir Exporter vers le serveur sur les objets de données.
- L'exportation de certaines instructions sur un serveur Oracle peut être à l'origine d'espacements entre les identifiants sur le serveur. Considérons par exemple l'instruction suivante : CREATE OR REPLACE TRIGGER SET_TRANSACTIONS_TRANID BEFORE INSERT ON TRANSACTIONS FOR EACH ROW WHEN (NEW.TRANID IS NULL) BEGIN SELECT TRANSACTIONS_TRANID_SQ.NEXTVAL INTO :NEW.TRANID FROM DUAL; END;
Après l'exécution de ce script sur le serveur, les identifiants spécifiés dans la clause SELECT peuvent apparaître différemment (par exemple, "TRANSACTION_TRANID_SQ.NEXTVAL" peut devenir "TRANSACTIONS_TRANID_SQ . NEXTVAL")
- Si le projet est un projet Java, l'éditeur affiche une icône en forme d'ampoule dans la barre de marqueurs, sur la première ligne d'une procédure mémorisée Java. Vous pouvez ignorer ce marqueur. Il ne pausera aucune difficulté lors de la génération de la procédure mémorisée Java.
- L'éditeur permet d'ajouter des points d'arrêt au code source d'une procédure mémorisée Java. Toutefois, ces points d'arrêt sont ignorés car le débogage de procédures mémorisées Java n'est pas encore pris en charge.
Si un document est réservé, c'est-à-dire marqué en lecture seule lorsqu'un éditeur l'ouvre, toutes les modifications en attente seront perdues à la fermeture de cet éditeur. Vérifiez si le document que vous ouvrez dans un éditeur est réservé.
Le chargeur de catalogues JDBC ne parvient pas à déterminer si un identificateur d'objet de schéma doit être délimité pour les paramètres nationaux correspondant à une autre langue qu'à l'anglais. Pour les identificateurs qui doivent être délimités, ouvrez l'éditeur de schéma/table après l'importation pour renommer l'objet de schéma. Pour déterminer le moment où un identificateur doit être délimité, reportez-vous à la documentation de votre serveur de base de données.
- Lors de la connexion à DB2 Universal Database for iSeries, vous devez sélectionner AS/400 Toolbox for Java JDBC Driver dans la liste déroulante des pilotes JDBC de l'assistant de nouvelle connexion à la base de données. Pour obtenir plus d'informations, reportez-vous à la rubrique d'aide "Création d'une connexion JDBC à l'aide d'un pilote DB2 Universal Database for iSeries".
- DB2 Universal driver pour Linux, Unix et Windows ne prennent pas en charge les procédures mémorisées Java et SQLJ.
- La connexion à partir d'un client DB2 v8 à un serveur DB2 v7 sous Linux, Unix et Windows n'est pas prise en charge.
Pour les autres serveurs DB2, reportez-vous à l'aide en ligne relative à la sélection de pilotes JDBC lors des connexions à la base de données.
Si vous utilisez DB2 Universal Database Version 7 sur votre poste de travail client et que vous vous connectez à DB2 Universal Database Version 8 sur le serveur, vous ne pourrez pas retirer les procédures mémorisées Java du serveur DB2 Version 8.
Lorsque vous utilisez l'assistant Nouvelle fonction utilisateur SQL pour créer une fonction UDF de table DB2, ce dernier recommande les types de données SQL comme données à renvoyer pour chaque colonne.
Si l'assistant ne parvient pas à mapper un type de données correspondant pour une colonne ou si vous voulez utiliser un autre type de données à renvoyer pour une colonne, ouvrez la fonction UDF générée dans l'éditeur et modifiez le type de données manuellement.
Vous pouvez obtenir le message d'erreur suivant lorsque vous tentez de compiler ou d'exécuter une fonction définie par l'utilisateur ou une procédure mémorisée DB2 :
[IBM][Pilote JDBC] CLI0600E. Invalid connection handle or connection is closed. SQLSTATE=S1000
Pour éviter cette erreur, il suffit de compiler ou d'exécuter à nouveau la routine. Le message d'erreur n'apparaît pas la deuxième fois et peut être ignoré.
WebSphere Studio inclut une version WebSphere du client Sequelink 5.1 JDBC dans le répertoire repinstall_WS/runtimes/aes_v4/lib/sljc.jar. Les outils de bases de données relationnelles WebSphere Studio ne permettent pas d'utiliser cette version du client pour la connexion JDBC. Le message d'erreur suivant peut s'afficher :
IWAS0126E Incidents survenus lors de la tentative d'établissement de la connexion nom_connexion Motif : La connexion n'a pas été établie car le fichier JAR sélectionné n'est pas un client DataDirect WebSphere. Vérifiez que le fichier JAR sélectionné provienne d'une installation WebSphere.
lorsque ce fichier JAR est indiqué dans la zone de l'emplacement de la classe JDBC de l'assistant de connexion. Une version du client dans laquelle l'utilisation des outils de bases de données relationnelles est activée est disponible auprès de votre partenaire commercial IBM.
WebSphere Studio Version 5.x inclut une nouvelle version du client JDBC DataDirect Sequelink. Le client JDBC DataDirect Sequelink 5.3 se trouve dans l'archive repinstall_WS/runtimes/base_v5/lib/sljc.jar. Reportez-vous à la documentation relative aux outils de bases de données relationnelles pour savoir comment connecter une base de données à l'aide du pilote JDBC Sequelink 5.1.
Pour que le contenu de l'assistant de connexion soit visible, la résolution minimale est 1280x1024.
- Lorsque vous utilisez les pilotes JDBC DataDirect SequeLink 5.1, 5.3 ou WebSphere Connect, vous ne pouvez pas extraire de tables de Microsoft SQL Server Version 7 si vous n'êtes pas le propriétaire de ces tables. Par exemple, si vous êtes propriétaire de la table 1 et de la table 2 de la base de données 2 et que vous indiquez dans l'assistant de connexion une connexion à la base de données 2, seules les tables 1 et 2 seront affichées même si ces tables n'appartient pas à la base de données B. Elles sont extraites car l'ID utilisateur ayant effectué la connexion est propriétaire de ces tables.
- Vous devez également être propriétaire de ces tables si vous utilisez les pilotes JDBC DataDirect SequeLink 5.1 ou 5.3 pour extraire les tables de Microsoft SQL Server 2000.
Si vous effectuez plusieurs actions de connexion et de déconnexion à l'aide de Cloudscape 5.1, des tables sans colonnes peuvent s'afficher dans la sous-fenêtre Serveurs de base de données. Si cette situation se produit, redémarrez WebSphere Studio.
L'importation, la suppression puis la nouvelle importation de fichiers JAR d'EJB (exemples ou autres) lorsque la perspective Données ou la perspective J2EE est ouverte peut provoquer l'affichage de noeuds de schéma en double sous les bases de données principales de ce fichier JAR d'EJB. Ces entrées ne sont à l'origine d'aucun dysfonctionnement mais il est recommandé d'arrêter et de redémarrer la perspective afin de supprimer les entrées en double.
Lors de l'exportation de données relationnelles vers une base de données UTF-8 UDB DB2 V7 en utilisant l'environnement local arabe, vous pouvez obtenir en cas d'erreurs des messages d'erreur corrompus. Il n'existe pas de solution pour cette situation.
Sous Linux GTK, lors de l'utilisation de l'assistant de création de procédure mémorisée, la sélection du bouton d'option relatif aux instructions SQL provoque l'arrêt de l'assistant. Solution : Utilisez Motif ou éditez l'instruction SQL manuellement.
Retour au fichier Readme principal
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.