Propriedades da Origem de Dados do WebSphere Application Server

Utilize essa página para definir propriedades avançadas de origem de dados no servidor de aplicativos. Essas propriedades ativam e configuram serviços que o servidor de aplicativos aplica às origens de dados para customizar conexões com um servidor de aplicativos. Essas propriedades não afetam as conexões no banco de dados.

Para acessar essa página do console administrativo, conclua um dos seguintes caminhos:
  • Recursos > JDBC > Origens de Dados > data_source > Propriedades da Origem de Dados do WebSphere Application Server
  • Recursos > JDBC > Provedores JDBC > JDBC_provider > Origens de Dados > data_source > Propriedades de Origem de Dados do WebSphere Application Server
  • Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos WebSphere > application_name > Recursos com Escopo Definido no Aplicativo > data_source > Propriedades da Origem de Dados do WebSphere Application Server.

Tamanho do Cache de Instruções

Especifica o número de instruções que podem ser armazenadas em cache por conexão. O servidor de aplicativos armazena em cache uma instrução depois de fechá-la.

A origem de dados do WebSphere Application Server otimiza o processamento de instruções preparadas e instruções que podem ser chamadas armazenando em cache aquelas instruções que não estão sendo usadas em uma conexão ativa. Os dois tipos de instrução ajudam a maximizar o desempenho das transações entre o aplicativo e o armazenamento de dados.
  • Uma instrução preparada é uma instrução SQL pré-compilada que é armazenada em um objeto PreparedStatement. O servidor de aplicativos utiliza esse objeto para executar a instrução SQL várias vezes, conforme exigido pelo tempo de execução do aplicativo, com valores determinados pelo tempo de execução.
  • Uma instrução chamável é uma instrução SQL que contém uma chamada a um procedimento armazenado, que é uma série de instruções pré-compiladas que executam uma tarefa e retornam um resultado. A instrução é armazenada no objeto CallableStatement. O servidor de aplicativos utiliza esse objeto para executar um procedimento armazenado várias vezes, conforme exigido pelo tempo de execução do aplicativo, com valores determinados pelo tempo de execução.

Se o cache não for grande o suficiente, entradas úteis serão descartadas para dar espaço a novas entradas. Para determinar o maior valor para o tamanho do cache de forma a evitar o descarte de caches, inclua simultaneamente o número de instruções preparadas exclusivamente e de instruções que podem ser chamadas, conforme determinado pela sequência SQL, além do tipo de rolagem, para cada aplicativo que utiliza a origem de dados em um servidor específico. Esse valor é o número máximo de possíveis instruções que podem ser armazenadas em cache em uma determinada conexão durante a existência do servidor. A configuração do tamanho do cache para esse valor significa que nunca haverá caches descartados. Em geral, configure um cache maior para aplicativos com um número maior de instruções.

[AIX Solaris HP-UX Linux Windows][IBM i]Você também pode utilizar o Tivoli Performance Viewer para minimizar descartes do cache. Utilize uma carga de trabalho padrão que represente um número típico de pedidos recebidos do cliente, um número fixo de iterações e um conjunto padrão de definições de configuração.
Nota: Quanto maior o cache de instruções, mais os recursos do sistema são atrasados. Portanto, se o número configurado for muito alto, talvez haja falta de recursos, pois o sistema não poderá abrir diversas instruções preparadas.

Se houver uma instrução específica que você não deseja que o servidor de aplicativos armazene em cache, configure a sugestão da capacidade de consulta da instrução como false. O servidor de aplicativos não armazenará uma instrução em cache se a sugestão da capacidade de consulta estiver configurada como false. O aplicativo especifica as sugestões de conjunto da instrução no tempo de execução.

Em aplicativos de teste, o ajuste do cache de instruções melhora o rendimento de 10% a 20%. Entretanto, por causa de possíveis limitações de recursos, o processo de ajuste nem sempre será possível.

Informações Valor
Tipo de D]ados Número Inteiro
Default Os valores padrão dependem do banco de dados. Normalmente, esse valor é 10. No Informix versões 7.3, 9.2, 9.3 e 9.4, sem as respectivas correções mais recentes, o valor padrão deve ser 0. Um valor padrão igual a 0 significa que não há instrução em cache.

Ativar Detecção de Acesso Multiencadeado

Se marcada, uma ou mais das seguintes mensagens de aviso serão inseridas no log de saída do sistema WebSphere Application Server se vários encadeamentos tentarem usar simultaneamente a mesma manipulação de conexões. Será possível usar esta propriedade para depurar problemas de conexão, se você achar que os problemas podem ser causados por diversos encadeamentos ao tentar usar o mesmo identificador de conexões. É uma violação do modelo de programação ter diversos encadeamentos que usam simultaneamente o mesmo identificador de conexões.
Nota: Dependendo das circunstâncias exatas de processamento, usar as conexões gerenciadas poderia resultar na emissão de uma mensagem, J2CA0167W ou DSRA8720W (ou ambas as mensagens). Você deve revisar os logs de tarefa para essas mensagens quando ativar detecção de acesso multiencadeado estiver ativado.

J2CA0167W: Foi detectada uma tentativa de usar simultaneamente o mesmo identificador de conexões por diversos encadeamentos. O identificador de conexões é: {0}.

DSRA8720W: Detectado acesso multiencadeado em {0}. Usado pela última vez com o ID de encadeamento: {1}id de acesso multiencadeado. ID de encadeamento atual: {2} Rastreio de pilha de encadeamento atual: {3}

Ativar Reautenticação do Banco de Dados

Indica que a correspondência exata nas conexões recuperadas do conjunto de conexões do servidor de aplicativos (o critério de procura do conjunto de conexões não inclui um nome de usuário e uma senha) não pode existir. Em vez disso, a nova autenticação da conexão é feita no doConnectionSetupPerTransaction() da classe DataStoreHelperass. O servidor de aplicativos não fornece uma implementação de reautenticação de conexão no tempo de execução. Por essa razão, quando você marcar essa caixa, será necessário estender a classe DataStoreHelper para fornecer a implementação do método doConnectionSetupPerTransaction() em que a nova autenticação ocorre. Se você não concluir esse processo, o servidor de aplicativos poderá retornar conexões inutilizáveis. Para obter informações adicionais, leia a documentação da API do método com.ibm.websphere.rsadapter.DataStoreHelper#doConnectionSetupPerTransaction.

A reautenticação de conexão pode ajudar a melhorar o desempenho, reduzindo a abertura e o fechamento de conexões, particularmente para aplicativos que frequentemente solicitam conexões com diferentes nomes de usuários e senhas.
Evitar Problemas Evitar Problemas: Você não pode ativar a reautenticação do banco de dados se selecionar TrustedConnectionMapping para o alias de configuração de mapeamento.gotcha

Ativar Suporte à Otimização de uma Fase do JMS

Quando você seleciona essa opção, o servidor de aplicativos usa o Java™ Message Service (JMS) para obter conexões otimizadas a partir dessa origem de dados. Essa propriedade impede que aplicativos JDBC (Java Database Connectivity) compartilhem conexões com aplicativos CMP (persistência gerenciada por contêiner). Essa opção não estará disponível se o provedor JDBC da origem de dados for um provedor XA.

Gerenciar Manipulações Armazenadas em Cache

Especifica se o contêiner rastreia manipulações armazenadas em cache, que são manipulações de conexões que um componente de aplicativo mantém ativas além dos limites de transações e métodos. Essa propriedade pode ser usada para depurar problemas de conexão, mas o rastreamento das manipulações pode causar grandes problemas de desempenho durante o tempo de execução.

Se a propriedade Gerenciar Manipulações Armazenadas em Cache estiver selecionada no console administrativo e for desmarcada, o campo não ficará mais visível para os recursos que forem da Versão 7.0 ou de versões superiores do servidor de aplicativos. Esse campo só será exibido se a propriedade manageCachedHandles estiver definida como true no arquivo resources.xml. Para disponibilizar o campo, altere o valor da entrada manageCachedHandles de false para true no arquivo resources.xml ou insira o seguinte comando Jython a partir da ferramenta wsadmin:
AdminConfig.modify(myDataSourceVariable, '[[manageCachedHandles "true"]]')
Nota: Para os recursos que estão em execução na Versão 6.x do servidor de aplicativos, a propriedade Gerenciar Manipulações Armazenadas em Cache fica sempre disponível. Por exemplo, se você tiver um nó na Versão 6.1, a entrada no arquivo resources.xml não afetará a forma como campo é exibido no console administrativo.
Para que um método diferente depure problemas, use os alertas de diagnósticos multiencadeados e de componente cruzado para detectar violações no modelo de programação do Java Connector Architecture (JCA). Para ativar esses alertas, selecione essas opções no painel Servidores > Servidores de Aplicativos > application_server > Desempenho > Configuração do Orientador de Diagnóstico e Desempenho > Configuração do Orientador de Diagnóstico e Desempenho. Esses alertas forçam o gerenciador de conexão a gerenciar tratamentos em cache, detectar condições de conexão e enviar alertas.
Nota: Para ativar esses alertas, selecione Ativar Estrutura do Orientador de Diagnóstico e Desempenho (Runtime Performance Advisor) no painel Servidores > Servidores de Aplicativos > application_server > Desempenho > Configuração do Orientador de Diagnóstico e Desempenho.

Faltando contexto de transação no log

Especifica se o contêiner emite uma entrada para o registro de atividades quando um aplicativo obtém uma conexão sem um contexto de transação. Essas são exceções aos requisitos de conexão do modelo de programação Java Platform, Enterprise Edition (Java EE).

Origem de Dados Não Transacionais

Especifica que o servidor de aplicativos não cadastra as conexões dessa origem de dados nas transações globais ou locais. Os aplicativos deverão chamar setAutoCommit(false) explicitamente na conexão caso queiram iniciar uma transação local na conexão, e devem confirmar ou recuperar a transação que foi iniciada.
Evitar Problemas Evitar Problemas: Configure esta propriedade como true em circunstâncias raras, exceto quando um aplicativo Java Persistence API (JPA) exigir as origens de dados JTA e não JTA. A origem de dados não JTA requer que essa propriedade seja configurada como true.gotcha

Utilizar Modelo de Verificação de Exceção do WebSphere Application Server

Especifica que o servidor de aplicativos utiliza o recurso de mapeamento de erro definido no auxiliar de armazenamento de dados para identificar erros. O servidor de aplicativos não substitui as exceções que são emitidas pelo driver JDBC pelas exceções definidas no mapa de erros do auxiliar de armazenamento de dados.

Utilizar Modelo de Mapeamento de Exceção do WebSphere Application Server

Especifica que o servidor de aplicativos usa o recurso de mapeamento de erros definido no auxiliar de armazenamento de dados para identificar erros, e o servidor de aplicativos substitui as exceções lançadas pelo driver JDBC por exceções definidas no mapa de erros do auxiliar do armazenamento de dados.

Nota: Esse modelo de detecção de erro funciona com JDBC Versão 3.0 e anterior.

Validar Novas Conexões

Especifica se o gerenciador de conexão testa as conexões recém-criadas com o banco de dados.

Número de Novas Tentativas

Especifica quantas vezes você deseja tentar novamente criar a conexão inicial com um banco de dados após a primeira operação pré-teste falhar.

Intervalo de tentativas

Se você selecionar Validar Novas Conexões, essa opção especificará a duração do tempo, em segundos, que o servidor de aplicativos aguarda antes de tentar novamente estabelecer uma conexão se a primeira tentativa falhar.

Validar Conexões Agrupadas Existentes

Especifica se o gerenciador de conexão testa a validade de conexões em conjunto antes de retorná-las aos aplicativos.

Intervalo de repetição

Se você selecionar Pré-testar conexões em conjunto existentes, essa opção especificará o tempo, em segundos, designado ao driver JDBC para validar uma conexão.

Validação por Driver JDBC

Especifica que o servidor de aplicativos usa o driver JDBC para validar as conexões. O provedor JDBC deve suportar JDBC 4.0 ou superior para utilizar essa opção. Essa opção só estará disponível se a opção Validar Novas Conexões ou Validar Conexões Agrupadas Existentes estiver selecionada.

Tempo Limite

Especifica o tempo limite, em segundos, para testar conexões, novas ou combinadas pelo servidor aplicativos, com o banco de dados. Se o tempo limite expirar antes da validação, a conexão será considerada não utilizável. Se novas tentativas estiverem configuradas, o valor completo do tempo limite será aplicado a cada uma. Um valor 0 indica que o driver JDBC não fixa um tempo limite nas tentativas de validação.
Nota: Essa opção só está disponível para drivers JDBC compatíveis com JDBC 4.0.

Validação por Cadeia SQL (Reprovado)

Especifica uma instrução SQL que o servidor de aplicativos envia ao banco de dados para testar a conexão. Utilize uma consulta que provavelmente tenha baixo impacto sobre o desempenho. Essa opção só estará disponível se a opção Validar Novas Conexões ou Validar Conexões Agrupadas Existentes estiver selecionada.

Otimizar para o Padrão de Conexão get/use/close com Conjunto Heterogêneo

Otimiza a origem de dados para os aplicativos que usam o padrão de conexão get/use/close. Essa otimização permite que o conjunto de conexões para a origem de dados compartilhe conexões que estiverem na mesma transação. Com esse padrão de otimização, é possível compartilhar uma conexão durante uma transação, mesmo se as conexões usarem propriedades de conexão diferentes.

Se você usar o recurso de conjunto heterogêneo, você deverá primeiro estender a definição da origem de dados para poder especificar propriedades customizadas ou aplicativos diferentes para substituir as propriedades não principais para a origem de dados. Para obter mais informações sobre como estender as origens de dados, consulte as informações sobre a extensão das definições de origem de dados DB2 no nível do aplicativo.

Nota: Esse campo estará disponível somente para origens de dados do DB2.

Intervalo de Novas Tentativas para Novo Roteamento do Cliente

Especifica o tempo, em segundos, entre novas tentativas de rotear novamente o cliente de forma automática.

Nota: Esse campo estará disponível somente para origens de dados do DB2.

Número Máximo de Novas Tentativas para Novo Roteamento do Cliente

Especifica o número máximo de novas tentativas de conexão que são feitas pela função de novo roteamento automático do cliente se a conexão primária com o servidor falhar. A propriedade só é utilizada quando Intervalo de Novas Tentativas para Novo Roteamento do Cliente está definido.

Nota: Esse campo estará disponível somente para origens de dados do DB2.

Nomes de Servidores Alternativos

Especifica a lista de nomes de servidores alternativos para o servidor DB2. Se mais de um nome do servidor alternativo for especificado, os nomes deverão ser separados por vírgulas. Exemplo:
host1,host2
Nota: Esse campo estará disponível somente para origens de dados do DB2.

Números de Portas Alternativas

Especifica a lista de portas alternativas de servidores para o servidor DB2. Se mais de uma porta alternativa de servidor for especificada, as portas deverão ser separadas por vírgulas. Por exemplo:
5000,50001
Nota: Esse campo estará disponível somente para origens de dados do DB2.

Nome JNDI da Lista de Servidores de Novo Roteamento do Cliente

Especifica o nome JNDI que é utilizado para ligar a lista de servidores de novo roteamento do cliente DB2 ao namespace JNDI. O servidor do banco de dadosDB2 usa esse nome para procurar pelas listas de nomes de servidores alternativos quando as informações do servidor alternativo ainda não estiverem na memória. Essa opção não é suportada em origens de dados do tipo 2.

Nota: Esse campo estará disponível somente para origens de dados do DB2.

Cancelar Ligação da Lista de Novos Roteamentos do Cliente da JNDI

Utilizado com conexão de teste somente. Quando configurado como true, o nome JNDI da lista de servidores de novo roteamento do cliente será desvinculado do namespace JNDI depois que uma conexão de teste for emitida.

Nota: Esse campo estará disponível somente para origens de dados do DB2.

Ícone que indica o tipo de tópico Tópico de Referência



Í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=udat_jdbcdatasorprops
Nome do arquivo: udat_jdbcdatasorprops.html