Ferramentas de Banco de Dados Relacional - Notas sobre o Release

1.0 Introdução
2.0 Software Suportado e Especificações
3.0 Limitações
   3.1 Deve Estar On-line para Gerar Java Bean ou Método EJB a partir de um Procedimento Armazenado
4.0 Problemas Conhecidos
   4.1 Gabaritos de Bancos de Dados
   4.2 Consultas SQL
   4.3 Conexões de Bancos de Dados
   4.4 SQL DDL
   4.5 Relatório de Erros
   4.6 A Execução de Instruções SQL Cria Tabelas Incorretas no Oracle
   4.7 Exportação de Dados
   4.8 Editando Procedimentos Armazenados Java
   4.9 Alterações Perdidas ao Fechar o Editor de Documento Somente Leitura
   4.10 Identificadores de Objeto Esquema sem Aspas para Locales que Não São em Inglês
   4.11 Conectando a um Servidor DB2
   4.12 A Eliminação de Procedimentos Armazenados Java do DB2 Versão 8 Não É Suportada Quando o Cliente DB2 Versão 7 Estiver Sendo Utilizado
   4.13 Alterando Manualmente os Tipos de Dados SQL Retornados para UDFs de Tabelas do DB2
   4.14 Erro ao Construir ou Executar uma Rotina do DB2 - Invalid connection handle ou connection is closed
   4.15 Problemas com o Sequelink 5.1 Fornecido com o WebSphere Studio
   4.16 Driver do DataDirect Sequelink 5.3
   4.17 O Conteúdo do Assistente Connection Não Está Visível
   4.18 Problemas em Recuperar Tabelas do Microsoft SQL Server
   4.19 Problemas em Conectar ao Cloudscape 5.1
   4.20 Nós de Esquema Duplicados Aparecerão ao Importar, Excluir ou Importar Novamente Arquivos JAR EJB
   4.21 Mensagens de Erro Corrupted Arabic Durante Exportação de Dados Relacional
   4.22 Criar Assistente de Procedimento Armazenado: Selecionando o Assistente de Interrupção de Instrução SQL Single/Multiple/No

1.0 Introdução

As ferramentas de banco de dados relacional no WebSphere Studio permitem que você conecte-se a bancos de dados, procure ou importe designs de banco de dados, projete novos bancos de dados utilizando assistentes, exporte novos designs para o banco de dados, crie e execute consultas SQL utilizando o SQL Builder, crie e execute procedimentos armazenados do DB2, bem como funções definidas pelo usuário do DB2. As ferramentas de banco de dados relacional são acessadas por meio das exibições Data Definition e DB Servers na perspectiva Data.

2.0 Software suportado e especificações

As ferramentas do banco de dados relacional suporta as conexões e importações dos seguintes tipos de banco de dados:

O suporte SQL no assistente para SQL e o construtor de consulta SQL dependem do nível do suporte fornecido pelo fornecedor do banco de dados.

Suporte para Fullselect:

Suporte de junções: Agrupando suporte a resultados de consulta: Suporte à expressão Cast:

No Linux, você pode passar por uma falha ao conectar-se ao DB2 Universal Database para iSeries V5R1 utilizando o AS/400 Toolbox para Java JDBC Driver. O problema ocorre quando você insere uma senha incorreta ou deixa o campo de senha em branco. Se isso ocorrer, inicie o produto novamente e conecte-se utilizando a senha correta.

3.0 Limitações

3.1 Deve Estar On-line para Gerar Java Bean ou Método EJB a partir de um Procedimento Armazenado

Para utilizar os assistentes que permitem gerar um Java Bean ou um método EJB a partir de um Procedimento Armazenado, você deve estar trabalhando on-line.

4.0 Problemas Conhecidos

4.1 Gabaritos de Banco de Dados

  1. Atualmente não há suporte para modelar índices, verificação e limitações exclusivas, disparos, tipos estruturados ou colunas de identidade.
  2. As ferramentas do banco de dados relacional não suportam opções de verificação nas exibições.

4.2 Consultas SQL

  1. Parênteses desnecessários nas instruções de consulta causarão erros de análise.
  2. A utilização de parênteses nas cláusulas de condição WHERE da consulta não é atualmente suportada.
  3. Arquivos SQL grandes podem tornar o editor lento.
  4. Para Oracle, as instruções de atualização devem atribuir valores a colunas individualmente sem o uso de grupos colocados entre parênteses. Para incluir colunas individualmente e incluir um valor utilizando uma subconsulta, utilize a opção "Build Expression" na caixa de combinação da célula da tabela Value para criar uma expressão de consulta para a coluna.
  5. As modificações nos objetos banco de dados utilizados por uma instrução podem ocasionar falha do SQL Builder porque ele não pode mais analisar a instrução com êxito para o gabarito de dados local.
  6. Editar uma exibição e, em seguida, abrir uma instrução que contém a exibição pode causar um encerramento inesperado do workbench.
  7. Se uma conexão de banco de dados for desconectada fora do WebSphere Studio, a conexão não será solicitada na execução da instrução. Reimporte o banco de dados para o projeto, a partir da exibição DB Servers, para restaurar a conexão.
  8. Uma consulta não pode ser criada utilizando uma exibição que seja derivada de uma função definida pelo usuário.
  9. O método arrastar e soltar para objetos banco de dados é suportado apenas na exibição Data Definition, e não na exibição DB Servers.

4.3 Conexões do Banco de Dados

  1. Se importar uma tabela DB2 UDB ou DB2 para iSeries com uma coluna do tipo DATALINK, as opções de controle de link da coluna não serão importadas. O comprimento de DATALINK será definido como 200 por padrão e as opções do link serão definidas como NO LINK CONTROL por padrão. É possível atualizar essas propriedades no editor da tabela após importar a tabela para a exibição Data.
  2. A remoção de várias conexões na exibição DB Servers nem sempre funciona. Se você encontrar esse problema, poderá manter suas conexões ou continuar removendo-as uma por vez.
  3. Os tipos de dados da cadeia de caracteres podem não ser importados corretamente para conexões com servidores iSeries. Os tipos CHAR FOR BIT DATA, VARCHAR FOR BIT DATA e LONG VARCHAR FOR BIT DATA podem ser importados sem as opções FOR BIT DATA. Nesses casos, utilize o editor de tabela na perspectiva Data para editar as colunas afetadas.
  4. Os nomes de objetos de esquemas que contêm caracteres DBCS não podem ser importados corretamente a partir do iSeries. Pode estar faltando aspas nos identificadores delimitados. Nesses casos, utilize o editor de tabela para editar a coluna e os nomes de limitação.
  5. Os identificadores para limitações de chave principal não são importados para as conexões do OS/390.
  6. Os valores padrão de coluna que são procedimentos armazenados, funções ou definidos com uma cláusula de identidade não são suportados corretamente e podem resultar em caracteres não-ASCII em um documento da tabela. Os caracteres não-ASCII causam problemas durante o carregamento do documento. Quando isso ocorre, é necessário editar manualmente o documento tblxmi do problema e remover a marcação e o valor padrão.
  7. Ao utilizar o driver JDBC do WebSphere Connect para conexões com um banco de dados SQL Server, normalmente são necessários 3 arquivos jar para especificar a localização da classe. Recomendamos que você combine esses arquivos jar em um único arquivo jar. Caso contrário, quando o assistente for reaberto depois de fazer uma conexão, ele estará anormalmente maior. Isso ocorre devido ao comprimento do campo Driver location.
  8. Ao criar uma nova conexão de banco de dados a partir de um cliente DB2 Versão 8, se quiser utilizar o Driver IBM DB2 NET DRIVER JDBC, você deve adicionar estes dois arquivos JAR ao campo Class location: <DB2HOME>/java/db2jcc.jar e <DB2HOME>/java/common.jar (em que <DB2HOME> é o diretório no qual o DB2 foi instalado). Se não fizer isso, ocorrerá um erro. Nota: Se você utilizar o Assistente New Database Connection sem adicionar esses arquivos JAR à sua localização de classe, os procedimentos armazenados não serão carregados. Você deverá tornar o assistente para conexão visível novamente para inserir os arquivos no campo Class location.
  9. Os metadados do esquema e da tabela não poderão ser importados quando o cliente DB2 UDB Versão 8 for utilizado para conectar a uma Versão 7 ou anterior do DB2 no z/OS. Para corrigir o problema, instale o DB2 para z/OS PTF UQ72081.

4.4 SQL DDL

  1. Você pode encontrar problemas na importação ou edição que envolve o tipo de dados longos Oracle.
  2. Arquivos SQL DDL muito grandes podem tornar o editor lento.
  3. Arquivos SQL DDL muito grandes podem causar exceções de falta de memória durante a análise ou execução.
  4. A edição de scripts do Oracle pode exibir erros na exibição Outline do editor. Por exemplo, as instruções "CREATE SEQUENCE", "CREATE OR REPLACE TRIGGER" e "END" serão mostradas como errôneas. No entanto, você pode continuar exportando esses itens para um servidor Oracle.

4.5 Relatório de Erros

Quando encontrar um erro durante a análise de um arquivo SQL, geralmente o problema está com o próximo sinal depois daquele reportado pela mensagem de erro. A mensagem de erro também é exibida na lista de tarefas.

4.6 A Execução de Instruções SQL Cria Tabelas Incorretas no Oracle

Quando um arquivo sql é executado no Oracle Database Server, é necessário inicialmente selecionar a criação das seqüências e disparos da tabela. Isso ocorre porque o WebSphere interage de forma incorreta com o Oracle, inserindo espaços extras. Depois das tabelas serem criadas, vá para a máquina do servidor Oracle e edite a instrução para remover os espaços inseridos e adicionar o comando 'end'. Em seguida, volte ao WebSphere e execute a instrução sql no servidor novamente, dessa vez, selecionando as instruções Alter e as instruções insert.

4.7 Exportação de Dados

  1. Você só pode eliminar artifacts existentes no banco de dados/catálogo de backend executando Run on Server em scripts SQL DDL. Em Data Objects (por exemplo, banco de dados, esquema e tabela), se você desejar eliminar os objetos existentes, deverá selecionar Generate DDL no menu pop-up, especificando para eliminar as instruções existentes. No script SQL DDL gerado, selecione Executar no Servidor no menu pop-up. Se os objetos não existirem atualmente no banco de dados/catálogo de backend, escolher Export to Server nos objetos de dados será suficiente.
  2. Exportar determinadas instruções para o servidor Oracle pode causar espaçamento nos identificadores no servidor. Por exemplo, uma instrução como: 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;

    Após a execução desse script para o servidor, os identificadores especificados na cláusula SELECT podem aparecer de modo diferente, por exemplo, "TRANSACTION_TRANID_SQ.NEXTVAL" pode aparecer como "TRANSACTIONS_TRANID_SQ . NEXTVAL"

4.8 Editando Procedimentos Armazenados Java

4.9 Alterações Perdidas ao Fechar o Editor de Documento Somente Leitura

Se for registrada a saída de um documento,, ou seja, se ele estiver marcado como somente para leitura enquanto um editor está aberto no documento, todas as alterações pendentes serão perdidas quando o editor for fechado. Assegure que seja registrada a saída de um documento antes que ele seja aberto em um editor.

4.10 Identificadores de Objeto Esquema sem Aspas para Locales que Não São em Inglês

O carregador de catálogo JDBC não pode determinar se um identificador de objeto de esquema deve ser delimitado para locales diferentes do inglês. Para identificadores que devem ser delimitados, após a importação abrir o editor de esquema/tabela para renomear o objeto de esquema. Consulte a documentação do servidor do banco de dados, para determinar quando um identificador deve ser delimitado.

4.11 Conectando a um Servidor DB2

Para outros servidores DB2, consulte a ajuda on-line para selecionar drivers JDBC quando fizer conexões do banco de dados.

4.12 A Eliminação de Procedimentos Armazenados Java do DB2 Versão 8 Não É Suportada Quando o Cliente DB2 Versão 7 Estiver Sendo Utilizado

Se você estiver trabalhando com o DB2 Universal Database Versão 7 em sua estação de trabalho cliente e conectando ao DB2 Universal Database Versão 8 no servidor, não será possível eliminar os procedimentos Java armazenados do servidor DB2 Versão 8.

4.13 Alterando Manualmente os Tipos de Dados SQL Retornados para UDFs da Tabela do DB2

Quando você utiliza o assistente para New SQL User-Defined Function para criar um UDF da tabela do DB2, o assistente recomenda tipos de dados SQL para os dados retornados para cada coluna.

Se o assistente não puder mapear um tipo de dados correspondente para uma coluna ou se você quiser utilizar um tipo de dados retornado diferente para uma coluna, abra o UDF gerado no editor e altere o tipo de dados manualmente.

4.14 Erro ao Construir ou Executar uma Rotina do DB2 - Invalid connection handle or connection is closed

Você pode encontrar a seguinte mensagem de erro ao tentar construir ou executar um procedimento armazenado do DB2 ou UDF:

[IBM][JDBC Driver] CLI0600E. Invalid connection handle or connection is closed. SQLSTATE=S1000

Para evitar esse erro, simplesmente construa ou execute a rotina novamente. A mensagem de erro não aparecerá na segunda vez e poderá ser ignorada.

4.15 Problemas com o Sequelink 5.1 Fornecido com o WebSphere Studio

O WebSphere Studio inclui uma versão do cliente JDBC Sequelink 5.1 com a marca do WebSphere em WS_installdir/runtimes/aes_v4/lib/sljc.jar. As ferramentas do banco de dados relacional do WebSphere Studio não estão ativadas para utilizar essa versão do cliente para conexão JDBC. Você poderá receber a mensagem de erro:

IWAS0126E Problems encountered while trying to establish connection connection_name Reason: Connection was not established because the selected JAR file is not a WebSphere branded DataDirect client. Assegure-se de que o JAR selecionado venha de uma instalação de WebSphere.

quando esse JAR for especificado no campo JDBC class location do assistente Connection. Uma versão do cliente de que as ferramentas do banco de dados relacional estão ativadas para utilizar está disponível com o Suporte IBM.

4.16 Driver do DataDirect Sequelink 5.3

O WebSphere Studio Versão 5.x inclui uma nova versão do cliente JDBC DataDirect Sequelink. O cliente JDBC DataDirect Sequelink 5.3 pode ser localizado no archive WS_installdir/runtimes/base_v5/lib/sljc.jar. Consulte a documentação das ferramentas do banco de dados relacional para saber como conectar a um banco de dados utilizando o driver JDBC do Sequelink 5.1.

4.17 O Conteúdo do Assistente Connection Não Está Visível

Uma resolução mínima de 1280x1024 é necessária para que o conteúdo do assistente Connection fique visível.

4.18 Problemas em Recuperar Tabelas do Microsoft SQL Server

4.19 Problemas em Conectar ao Cloudscape 5.1

Várias ações de conexão e desconexão utilizando o Cloudscape 5.1 podem resultar em tabelas sem colunas na área de janela DB Servers. Se esse problema ocorrer, reinicie o WebSphere Studio.

4.20 Nós de Esquema Duplicados Aparecem ao Importar, Excluir ou Importar Novamente Arquivos JAR EJB

Importar, excluir e importar novamente arquivos JAR EJB (amostras ou outros) com a Perspectiva Data ou a Perspectiva J2EE aberta, ou ambas, ocasionalmente resultará na aparição de nós de esquema duplicados sob os bancos de dados de backend para o arquivo JAR EJB. As entradas são inofensivas, no entanto recomenda-se encerrar e reiniciar a perspectiva para remover as entradas duplicadas.

4.21 Mensagens de Erro Corrupted Arabic Durante Exportação de Dados Relacional

Ao exportar dados relacionais para um banco de dados UTF-8 UDB DB2 V7, utilizando locale Arábico, você pode receber mensagens de erro corrompidas, se ocorrerem erros. Não existe solução alternativa para esse problema.

4.22 Criar Assistente de Procedimento Armazenado: Selecionando o Assistente de Interrupção de Instrução SQL Single/Multiple/No

No Linux GTK, ao utilizar o Assistente Create SQL Stored Procedure, selecionar o botão de opções de instruções SQL single/multiple/no faz com que o assistente seja interrompido. Solução alternativa: Utilize Motif ou edite a instrução SQL manualmente.

Retornar para o arquivo Leia-me principal