Propriedades da Origem de Dados do WebSphere Application Server

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.

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.

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.

Se verificada, a seguinte mensagem de aviso será inserida no log de saída do sistema WebSphere Application Server, se diversos encadeamentos tentarem usar simultaneamente o mesmo identificador 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.

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

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: Você não pode ativar a reautenticação do banco de dados se selecionar TrustedConnectionMapping para o alias de configuração de mapeamento.gotcha

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.

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.

AdminConfig.modify(myDataSourceVariable, '[[manageCachedHandles "true"]]')

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

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.

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.

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

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.

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.

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

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.

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.

Evitar Problemas: Para uma origem de dados Oracle, Validação pelo Driver JDBC é exibido no console administrativo somente após a propriedade validateNewConnectionTimeout ser incluída nas propriedades customizadas da origem de dados. A propriedade validateNewConnectionTimeout é usada para validação do driver JDBC 4.0 e pode ser especificada com o console administrativo.gotcha

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.

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.

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

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.

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.

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.