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
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
- 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.
- 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.