1.0 Introduction
2.0 Spécifications et logiciels pris en charge
3.0 Limitations
3.1 Etre en ligne pour générer la méthode Java Bean ou EJB à partir d'une procédure stocké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 des procédures stockées Java
4.9 Perte des modifications lors de la fermeture de l'éditeur pour les documents en lecture seule
4.10 Guillemets manquants dans les identificateurs d'objet de schéma pour les environnements locaux autres qu'en anglais
4.11 Connexion à un serveur DB2
4.12 La suppression des procédures stockées Java depuis DB2 version 8 n'est pas prise en charge lors de l'utilisation du client DB2 version 7
4.13 Modification manuelle des types de données SQL renvoyés pour les fonctions UDF de table DB2
4.14 Erreur lors de la génération ou de l'exécution d'une routine DB2 - Descripteur de connexion incorrect ou connexion fermée
4.15 Problèmes avec la version Sequelink 5.1 fournie 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 Les exemples de fichiers SQL de WebSphere Application Server - Express peuvent contenir des erreurs mais peuvent quand-même être exécutés
4.19 Exécution de Cloudscape sur Linux
4.20 Problèmes d'extraction de tables à partir de Microsoft SQL Server
4.21 Problèmes de connexion à Cloudscape 5.1
4.22 Des noeuds de schéma en double apparaissent lors de l'importation, la suppression ou la réimportation de fichiers JAR EJB
4.23 Message d'erreur d'environnement local endommagé au cours de l'exportation de données relationnelles
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 pour les jointures externes gauche et droite coïncide avec la syntaxe Oracle "+" dans 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, une panne peut se produire lors de la connexion à DB2 Universal Database pour iSeries V5R1 à l'aide d'AS/400 Toolbox for Java JDBC Driver. Cet incident se produit lorsque vous entrez un mot de passe incorrect ou que vous ne renseignez pas la zone du mot de passe. Dans ce cas, redémarrez le produit et connectez-vous de nouveau en utilisant le mot de passe approprié.
Pour utiliser les assistants qui vous permettent de générer un bean Java ou de générer une méthode EJB à partir d'une procédure stockée, 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 de base de données relationnelle ne prennent pas en charge les options de vérification 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 BD 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 concerné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 sont des procédures stockées, des fonctions, ou définies avec une clause d'identité ne sont pas importées correctement et peuvent résulter en des caractères non-ASCII dans un document tabulaire. Les caractères non-ASCII pausent problème 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.
- Lors de l'utilisation du pilote WebSphere Connect JDBC pour les connexions à une base de données SQL Server, trois fichiers JAR sont nécessaires pour spécifier l'emplacement de classe. 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. Ceci est dû à la longueur du champ Emplacement du pilote.
- Lors de la création d'une nouvelle connexion à une base de données à partir d'un client DB2 version 8, si vous souhaitez utiliser le IBM DB2 NET DRIVER JDBC Driver, vous devez ajouter les deux fichiers JAR suivants au champ Emplacement de classe : <DB2HOME>/java/db2jcc.jar et <DB2HOME>/java/common.jar (où <DB2HOME> est le répertoire où vous avez installé DB2). Si vous ne le faites pas, une erreur sera générée. Remarque : Si vous utilisez l'assistant de nouvelle connexion à une base de données sans ajouter ces fichiers JAR à votre emplacement de classe, les procédures stockées ne seront pas chargées. Vous devez relancer l'assistant de connexion pour entrer les fichiers dans le champ Emplacement de classe.
- Les métadonnées de schéma et de table peuvent ne pas être importées lors de l'utilisation d'un client DB2 UDB version 8 pour effectuer une connexion à une version 7 ou inférieure de DB2 sur z/OS. Pour résoudre ce problème, installez DB2 pour z/OS PTF UQ72081.
- 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" apparaîtront erronées. 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 de commencer par sélectionner pour créer les séquences et déclencheurs de tables. Cela est dû au fait que WebSphere interagit incorrectement avec Oracle en insérant des espaces supplémentaires. Une fois que les tables ont été créées, sur la machine serveur Oracle, éditez l'instruction de manière à retirer les espaces insérés et ajoutez la commande "end;". Revenez ensuite sur WebSphere et exécutez de nouveau l'instruction SQL sur le serveur, cette fois en sélectionnant les instructions Alter et les instructions 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 marqueur sur la première ligne d'une procédure stocké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 la procédure stockée 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 pour iSeries, vous devez sélectionner le AS/400 Toolbox for Java JDBC Driver dans le champ Pilote JDBC de l'assistant de nouvelle connexion à une base de données. Pour plus d'informations, reportez-vous à la rubrique d'aide "Création d'une connexion JDBC à l'aide d'un pilote DB2 Universal Database pour iSeries."
- Le pilote DB2 Universal pour Linux, Unix et Windows ne prend pas en charge les procédures stockées Java et SQLJ.
- La connexion à partir d'un client DB2 version 8 à un serveur DB2 version 7 sur Linux, Unix et Windows n'est pas pris 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.
Le message d'erreur suivant peut s'afficher si vous essayez de générer ou d'exécuter une procédure stockée DB2 ou une fonction UDF :
[IBM][JDBC Driver] CLI0600E. Descripteur de connexion non valide ou connexion fermée. SQLSTATE=S1000
Pour éviter cette erreur, générez ou exécutez la routine de nouveau. Le message d'erreur n'apparaîtra pas la deuxième fois et peut être ignoré.
WebSphere Studio inclut une version personnalisée de WebSphere du client Sequelink 5.1 JDBC dans rép_intall_WS/runtimes/aes_v4/lib/sljc.jar. Les outils de base de données relationnelle WebSphere Studio ne peuvent pas utiliser cette version du client pour la connexion JDBC. Le message d'erreur suivant peut être généré :
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 personnalisé. Vérifiez que le fichier jar sélectionné provient d'une installation WebSphere.
lorsque ce fichier JAR est spécifié dans le champ JDBC class location de l'assistant de connexion. Une version du client pouvant être utilisée par les outils de base de données relationnelle est disponible auprès du support technique 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 rép_install_WS/runtimes/base_v5/lib/sljc.jar. Reportez-vous à la documentation des outils de base de données relationnelle pour connaître le moyen de se connecter à la base de données à l'aide du pilote Sequelink 5.1 JDBC.
Une résolution minimale de 1280 x 1024 est nécessaire pour que le contenu de l'assistant de connexion soit visible.
Les fichiers SQL de chaque dossier de projet de configuration/base de données WebSphere Application Server - Express peuvent contenir des erreurs d'analyse erronées affichées dans la vue Structure (Outline) de la perspective Données. Toutefois, les fichiers SQL s'exécutent correctement en utilisant l'action "Exécuter sur le serveur" décrite dans les exemples du fichier README.html.
WebSphere Application Server - Express est fourni avec une base de données Cloudscape pré-alimentée.
Pour utiliser Cloudscape sur Linux, utilisez le script de shell EXPcview.sh fourni dans le répertoire /opt/IBM/WebSphere/Express/Express/bin.
- Si vous utilisez les pilotes DataDirect SequeLink 5.1, 5.3 ou WebSphere Connect JDBC, vous ne pouvez pas extraire les tables de Microsoft SQL Server version 7 si vous n'êtes pas le propriétaire de ces tables. Par exemple, si vous possédez Table1 et Table2 sur BaseA, et spécifiez dans l'assistant de connexion de base de données d'effectuer une connexion à la BaseB, seules Table1 et Table2 seront affichées bien que ces tables n'appartiennent pas à la DatabaseB, mais sont extraites car l'ID utilisateur utilisée pour la connexion est celle du propriétaire des tables.
- Vous devez également être propriétaire des tables si vous utilisez les pilotes DataDirect SequeLink 5.1 ou 5.3 JDBC pour extraire les tables de Microsoft SQL Server 2000.
Des actions de connexion et de déconnexion répétées à l'aide de Cloudscape 5.1 peuvent conduire à des tables sans colonnes dans la sous-fenêtre Serveurs BD. Si ce problème survient, redémarrez WebSphere Studio.
L'importation, la suppression et la réimportation de fichiers JAR EJB (exemples ou autres) avec soit la perspective Données, soit la perspective J2EE ouverte, ou les deux, entraîne parfois l'apparition de noeuds de schéma en double sous les bases de données backend pour ce fichier JAR EJB. Les entrées sont sans risque mais il est recommandé de fermer 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 des messages d'erreur d'environnement local endommagé en cas d'erreur. Il n'existe pas de solution à ce problème.
Retour au fichier Readme principal
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.