Configurando provedores JDBC de origem de dados para usarem o pureQuery em um ambiente Java SE

Use esta tarefa para configurar o provedor Java™ Database Connectivity (JDBC) da origem de dados do aplicativo para usar o pureQuery para acessar o DB2 em um ambiente Java Standard Edition (Java SE). Esta configuração destina-se ao uso com o provedor de especificação Java™ Persistence API (JPA) 2.0, WSJPA.

Antes de Iniciar

Se precisar usar várias coletas de pacotes do DB2, consulte o tópico do centro de informações, Configurar o pureQuery para Usar Várias Coletas de Pacotes, antes de continuar com esta tarefa.

Sobre Esta Tarefa

O IBM® Optim PureQuery Runtime faz uso dos pacotes do DB2. Esses pacotes incluem informações sobre uma ou mais instruções de Linguagem de Consulta Estruturada (SQL) e são armazenados no catálogo do DB2. Primeiro você deve executar o comando wsdbgen em um aplicativo Java Persistence API (JPA) para criar os pacotes. O comando wsdbgen cria um arquivo XML contendo informações de instrução SQL. Esse arquivo XML deve ser incluído no arquivo JAR (Java archive) do aplicativo. O comando bind do DB2 utiliza esse arquivo como entrada para criar o pacote do DB2.
Importante:
  • A JPA configura a propriedade pdq.executionMode do IBM Optim PureQuery para o valor STATIC.
  • O caminho de classe deve incluir o local de instalação para o IBM Optim PureQuery Runtime. Consulte o tópico do centro de informações sobre como instalar o IBM Optim PureQuery Runtime para obter informações adicionais.
  • A implementação do provedor JPA deve ser a JPA do servidor de aplicativos (com.ibm.websphere.persistence.PersistenceProviderImpl). Os provedores de persistência OpenJPA e EclipseLink não fornecem suporte para pureQuery.
  • O comando wsdbgen requer a URL de um banco de dados. O comando wsdbgen força uma função de mapeamento sincronizado que cria ou altera as tabelas necessárias. Para DB2 zOS, os índices exclusivos e tabelas LOB V8 devem ser criados manualmente antes da execução do comando wsdbgen.
As propriedades do IBM Optim PureQuery Runtime são especificadas em um arquivo pdq.properties no diretório META-INF do arquivo JAR do aplicativo. A propriedade pdq.ExecutionMode é padronizada como STATIC para aplicativos JPA. É possível usar a propriedade pdqProperties para usar pureQuery em modo DINÂMICO. Consulte o tópico do centro de informações, Usando pureQuery em Modo Dinâmico, para obter informações adicionais. As propriedades do PDQ, se especificadas, passam no IBM Optim PureQuery Runtime. Consulte a documentação do IBM Optim PureQuery Runtime para obter uma lista de propriedades e de valores válidos.
  • wsjpa.jdbc.CollectionId : Valor de cadeia que especifica o ID de coleta a ser usado. Esse parâmetro substitui qualquer ID de coleção que for usado durante o wsdbgen.
Atenção: Consulte sobre o nível de conformidade do DB2 JAR para o IBM Optim PureQuery Runtime no Web site de Suporte IBM: Requisitos do sistema para o IBM Optim PureQuery Runtime for Linux, UNIX e Windows.

Procedimento

  1. Atualize a configuração do provedor JDBC de origem de dados do aplicativo para incluir os arquivos JAR do IBM Optim PureQuery Runtime. Inclua os arquivos pdq.jar e pdqmgmt.jar no caminho de classe além dos arquivos jar do driver JDBC. Defina um novo provedor JDBC ou modifique um provedor existente para incluir os arquivos JAR. O caminho de classe deve incluir o local de instalação para o IBM Optim PureQuery Runtime. Consulte os tópicos do centro de informações sobre configurações do provedor JDBC e sobre como instalar o IBM Optim PureQuery Runtime para obter informações adicionais.
  2. Usando o comando bind do DB2 fornecido pelo IBM Optim PureQuery Runtime, ligue o arquivo XML ao banco de dados. Isso cria os pacotes DB2. Consulte o tópico do Centro de Informações sobre o utilitário de ligação de pureQuery para obter informações adicionais.

O que Fazer Depois

Para reconfigurar a origem de dados do JDBC, remova pdq.jar e pdqmgmt.jar do caminho de classe.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_configpdqjpase
Nome do arquivo: tejb_configpdqjpase.html