Ferramentas de Banco de Dados Relacional - Notas sobre o Release

1.0 Introdução
2.0 Software Suportados e Especificações
3.0 Limitações
   3.1 Necessário Estar On-line para Gerar Método Java Bean ou 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 Renomeando Pastas no Projeto do Banco de Dados
   4.9 Comentários de SQL
   4.10 Registrar Entrada e Saída de Instruções SQL antes de Abri-las no SQL Builder
   4.11 Não Adicionar Imediatamente Instruções SQL Recém-criadas ao Controle de Versões
   4.12 Editando Procedimentos Armazenados Java
   4.13 Os Dados DBCS são Truncados ao Conectarem-se ao DB2/390 (CP930)
   4.14 Alterações Perdidas ao Fechar o Editor de Documento Somente Leitura
   4.15 Identificadores de Objeto Esquema sem Aspas para Locales que Não São em Inglês
   4.16 Conectando-se a um Servidor DB2
   4.17 A Eliminação de Procedimentos Armazenados Java do DB2 Versão 8 Não é Suportada ao Utilizar o Cliente DB2 Versão 7
   4.18 Alterando Manualmente os Tipos de Dados SQL Retornados para UDFs de Tabelas do DB2
   4.19 Problemas com o Sequelink 5.1 Fornecido com o WebSphere Studio
   4.20 Driver DataDirect Sequelink 5.3
   4.21 Os Arquivos SQL de Exemplos do WebSphere Application Server - Express Podem Conter Erros, mas Podem Ser Executados com Êxito
   4.22 Problemas ao Recuperar Tabelas do Microsoft SQL Server
   4.23 Problemas ao Conectar-se ao Cloudscape 5.1
   4.24 Mensagem de Erro ao Mover/Renomear/Excluir o Arquivo Jar do JDBC
   4.25 Nós de Esquema Duplicados Aparecerão ao Importar, Excluir ou Importar Novamente Arquivos JAR de EJB
   4.26 Mensagens de Erro Corrupted Arabic Durante Exportação de Dados Relacionais

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 com o 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, reinicie o produto e conecte novamente utilizando a senha correta.

3.0 Limitações

3.1 Necessário Estar On-line para Gerar Método Java Bean ou 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, é necessário estar 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. No entanto, 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. Você pode atualizar essas propriedades no editor de tabela depois de 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 tabelas para editar a coluna e limitar nomes.
  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 da coluna que são procedimentos armazenados, funções ou definidos com uma cláusula identity não são importados corretamente e podem resultar em caracteres não-ASCII em um documento de 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 a um banco de dados do SQL Server, você geralmente precisa de 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 ao banco de dados a partir de um cliente DB2 Versão 8, se você quiser utilizar o Driver IBM DB2 NET DRIVER JDBC, será necessário adicionar estes dois arquivos JAR ao campo Class location: <DB2HOME>/java/db2jcc.jar e <DB2HOME>/java/common.jar (em que <DB2HOME> é o diretório em que o DB2 foi instalado). Caso contrário, você receberá um erro. Nota: Se você utilizar o New Database Connection Wizard sem adicionar esses arquivos JAR à localização da classe, os procedimentos armazenados não serão carregados. Será necessário 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 poderão não ser importados ao utilizar um cliente DB2 UDB Versão 8 para conexão a uma Versão 7 ou anterior do DB2 no z/OS. Para corrigir o problema, instale o PTF UQ72081 do DB2 para z/OS.

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 exibidas como incorretas. 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 servidor de banco de dados do Oracle, é necessário selecionar inicialmente para criar as seqüências de tabelas e os acionadores. Isso é porque o WebSphere interage incorretamente com o Oracle inserindo espaços extras. Depois da criação das tabelas, vá para a máquina do servidor Oracle e edite a instrução para retirar os espaços inseridos e adicione o comando 'end;'. Em seguida, volte para o WebSphere e execute a instrução SQL no servidor novamente, desta vez, selecionando as instruções Alter e 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 popup, especificando para eliminar as instruções existentes. No script SQL DDL gerado, selecione Run on Server no menu popup. 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 Renomeando Pastas no Projeto do Banco de Dados

Alterar o nome de uma pasta dentro de um projeto que contém um banco de dados interromperá referências de URI nos arquivos relacionados ao banco de dados no projeto e causará erros. Se uma pasta tiver que ser renomeada, todas as referências relacionadas nos arquivos relacionados ao banco de dados deverão ser alteradas. Por exemplo, a seguinte referência existe em um arquivo de objeto tabela (com extensão .tblxmi) e o banco de dados no projeto está contido em uma pasta denominada folder1:

<database href="folder1/Con1_VIDEOS.dbxmi#RDBDatabase_1"/>

Se o nome da pasta for alterado para folder2, essa linha deverá ser alterada para refletir a alteração:

<database href="folder2/Con1_VIDEOS.dbxmi#RDBDatabase_1"/>

4.9 Comentários de SQL

Os comentários de SQL (linhas precedidas por traço duplo: --) não são suportados no SQL Builder.

4.10 Registrar Entrada e Saída de Instruções SQL antes de Abri-las no SQL Builder

Se você estiver editando Instruções SQL (arquivos .sqx) que estejam sob controle de versão, assegure-se de que a instrução não esteja aberta no SQL Builder quando estiver registrando a entrada e saída delas. Registre a saída do arquivo (na exibição Navigator) e, em seguida, edite a instrução. Depois de concluir a edição da instrução, salve suas alterações, feche o SQL Builder e registre novamente a entrada do arquivo.

4.11 Não Adicionar Imediatamente Instruções SQL Recém-criadas ao Controle de Versões

Se você criar uma nova Instrução SQL e for solicitado para adicioná-la ao controle de versões, não o faça. Faça as alterações necessárias no arquivo utilizando o SQL Builder, feche o arquivo, em seguida, inclua-o para controle de versão.

4.12 Editando Procedimentos Armazenados Java

4.13 Os Dados DBCS são Truncados ao Conectarem-se ao DB2/390 (CP930)

Devido a uma limitação do JDBC, ao conectar-se ao DB2/390 (CP930), alguns dados DBCS são truncados com base no comprimento de dados da codificação UTF-8. 10 caracteres SBCS Katakana podem ser recebidos como 3 caracteres Katakana por uma instrução "SELECT". Os dados reais armazenados em uma tabela no OS/390 são '8182838485868788898A' em hexadecimal, que são 10 caracteres Japonês Katakana (1 byte para 1 caractere). No entanto, ao utilizar o driver JDBC com a definição padrão, os dados de consulta recebidos mostram apenas 3 caracteres ('efbdb1efbdb2efbdb3') como a cadeia de 9 bytes válida no UTF-8, que seria extraída de 'efbdb1efbdb2efbdb3efbdb4efbdb5efbdb6efbdb7efbdb8efbdb9efbdba' no driver JDBC.

4.14 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.15 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.16 Conectando-se 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.17 A Eliminação de Procedimentos Armazenados Java do DB2 Versão 8 Não é Suportada ao Utilizar o Cliente DB2 Versão 7

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.18 Alterando Manualmente os Tipos de Dados SQL Retornados para UDFs de Tabelas 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.19 Problemas com o Sequelink 5.1 Fornecido com o WebSphere Studio

O WebSphere Studio inclui uma versão da marca WebSphere do cliente JDBC Sequelink 5.1 no WS_installdir/runtimes/aes_v4/lib/sljc.jar. As ferramentas do banco de dados relacional do WebSphere Studio não são ativadas para utilizar essa versão da conexão do cliente para 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. Ensure the selected JAR comes from a WebSphere install.

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

4.20 Driver DataDirect Sequelink 5.3

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

4.21 Os Arquivos SQL de Exemplos do WebSphere Application Server - Express Podem Conter Erros, mas Podem Ser Executados com Êxito

Os arquivos SQL da pasta de projetos Setup/databases de cada exemplo do WebSphere Application Server - Express podem conter erros de análise incorretos, conforme mostrado na exibição Outline da perspectiva Data. No entanto, os arquivos SQL são executados com êxito utilizando a ação "Run on database server", conforme descrito no arquivo README.html de exemplos.

4.22 Problemas ao Recuperar Tabelas do Microsoft SQL Server

4.23 Problemas ao Conectar-se ao Cloudscape 5.1

Várias ações de conexão e desconexão ao utilizar o Cloudscape 5.1 podem resultar em tabelas sem colunas na área de janela do DB Servers. Se encontrar esse problema, inicie novamente o WebSphere Studio.

4.24 Mensagem de Erro ao Mover/Renomear/Excluir o Arquivo Jar do JDBC

Os arquivos jar do JDBC, isto é, os arquivos jar especificados no campo de localização de classe do assistente Connection, ficam travados para uso na sessão atual do JVM depois da primeira vez que uma conexão é estabelecida. As tentativas de renomear/mover/excluir os arquivos jar resultará na seguinte mensagem de erro: 'The process cannot access the file because it is being used by another process.' O arquivo será destravado quando o workbench for encerrado.

4.25 Nós de Esquema Duplicados Aparecerão ao Importar, Excluir ou Importar Novamente Arquivos JAR de EJB

Importar, excluir e reimportar arquivos JAR do EJB (amostras ou outra coisa) com a perspectiva Data ou a perspectiva J2EE aberta, ou ambas, provoca, ocasionalmente, o aparecimento de nós de esquema em duplicata nos bancos de dados de backend desse arquivo JAR do EJB. As entradas não são prejudiciais, no entanto, recomenda-se encerrar e iniciar novamente a perspectiva para remover as entradas em duplicata.

4.26 Mensagens de Erro Corrupted Arabic Durante Exportação de Dados Relacionais

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.

Retornar para o Arquivo Leia-me Principal