Dados de Monitoramento do Java Database Connectivity (JDBC)

É possível definir uma origem de dados para receber dados de um banco de dados JDBC. O agente executa uma consulta SQL para coletar os dados do banco de dados. Cada coluna que é retornada pela consulta é um atributo no conjunto de dados resultante.

1. Na página Origem Inicial de Dados do Agente ou na página Local de Origem de Dados, clique em Dados de um servidor na área Categorias de Dados de Monitoramento.
2. Na área Origens de Dados, clique em JDBC.
3. Clique em Avançar.
4. Na área Informações de JDBC na página Informações de JDBC, clique em Procurar para conectar-se a um banco de dados e construa sua Consulta SQL.
   Use o navegador JDBC para conectar-se a um banco de dados e visualizar suas tabelas, para que você possa construir uma consulta SQL que coleta os dados que você precisa. Ao selecionar uma tabela e colunas, uma consulta será gerada para você e atributos serão incluídos para cada uma das colunas retornadas pela consulta. É possível modificar e testar a consulta que é gerada para verificar se os dados que forem retornados são os dados necessários.

   Nota: Você também pode criar manualmente a origem de dados JDBC sem clicar em Procurar. Se desejar criar manualmente a origem de dados, especifique a consulta e clique em Avançar. Deve-se definir um atributo para cada coluna retornada pela consulta, na ordem em que as colunas são retornadas.

   Com o provedor de dados JDBC, é possível executar consultas SQL e procedimentos armazenados com relação a um banco de dados para coletar dados de monitoramento. Ao especificar uma consulta SQL para coletar dados, é possível incluir uma cláusula where em sua instrução SQL para filtrar os dados retornados. A instrução SQL também pode unir dados a partir de várias tabelas. Além das instruções select SQL, o provedor de dados JDBC pode executar procedimentos armazenados. Para obter informações sobre como executar procedimentos armazenados, consulte Procedimentos armazenados.

5. A primeira vez em que o Navegador for aberto, a janela Navegador de Java Database Connectivity (JDBC) indica que nenhuma conexão está selecionada. Você deve incluir uma conexão. Clique em Incluir e siga as Etapas para incluir uma conexão.
   Se você já definiu uma conexão, essa conexão é usada e é possível continuar para a Etapa 6.

   Nota: O campo Status mostra o status da conexão atual.

   Use as etapas a seguir para incluir uma conexão:
   1. Na página Conexões JDBC, clique em Conexão JDBC e clique em Avançar.
   2. Na página Propriedades da Conexão, preencha os campos da seguinte forma:

      Nome de Conexão

      Nome da conexão do JDBC. Digite um nome exclusivo para essa conexão. Use esse nome para referenciar a conexão no navegador.

      Database Type

      O tipo do banco de dados. Selecione o produto de banco de dados para o qual você está conectando. Por exemplo, para se conectar ao banco de dados IBM DB2, selecione DB2.

      Nome do Usuário

      Deve ser definido com pelo menos acesso de leitura ao banco de dados, mas não tem de ser o administrador de banco de dados

      Password

      Deve ser definido com pelo menos acesso de leitura ao banco de dados, mas não tem de ser o administrador de banco de dados

      Nome de Host

      Nome do host em que o servidor de banco de dados está em execução. Com JDBC, é possível monitorar bancos de dados remotos, assim você não está restrito a monitorar bancos de dados no sistema local.

      Port

      Porta no nome do host em que o servidor de banco de dados está atendendo.

      Banco de Dados

      Nome do banco de dados a ser conectado.

      Diretório Jar

      Diretório contendo os arquivos JAR JDBC usados para conectar-se ao banco de dados. Digite o nome do caminho ou clique em Procurar para localizar o diretório.

   3. Opcional: Selecione a caixa de opção Salvar a senha na área de trabalho do Agent Builder se desejar salvar a senha para esta conexão.
   4. Opcional: Selecione a caixa de opção Configurar como Padrões de Configuração do Agente, se desejar que os padrões para este tipo de servidor de aplicativos sejam copiados destas propriedades.
      Se você estiver construindo o agente em um sistema que é semelhante a seus sistemas monitorados, é aconselhável verificar essa caixa. Se essa caixa não for marcada, o usuário que configura o agente vê um campo vazio. O usuário deve então determinar os valores para todas as informações sem valores padrão.
   5. Clique em Conexão de Teste para criar uma conexão com o banco de dados que usa os parâmetros de configuração que você especificou.
      Uma mensagem na página Propriedades de Conexão indica se a conexão é bem-sucedida.
   6. Quando tiver uma conexão ativa, clique em Concluir.
6. Na janela Navegador do Java Database Connectivity (JDBC), é feita uma conexão com o banco de dados configurado. As tabelas contidas no banco de dados são mostradas na área Tabelas de Banco de Dados. Selecione a tabela de banco de dados para ver as colunas contidas nessa tabela na área Colunas na tabela selecionada.
   Nota:

   1. Clique no ícone de binóculos para procurar por uma tabela na lista Tabelas de Banco de Dados.
   2. Todas as tabelas são mostradas por padrão. É possível filtrar as tabelas mostradas selecionando uma opção de filtro diferente. As opções de filtro disponíveis são mostradas em Tabela 1.

      Tabela 1. Opções de filtro

      Opção de filtro	Descrição
      Todos	Mostrar todas as tabelas
      Usuário	Mostrar somente tabelas de usuários
      Sistema	Mostrar somente tabelas de sistemas
      Visualizar	Mostrar somente visualizações do banco de dados

   Nota: Se você deseja recuperar colunas específicas, selecione somente essas colunas. Se você selecionar a tabela, o Agent Builder constrói automaticamente uma consulta que reúne todas as colunas a partir da tabela e cria atributos para todas as colunas que estiverem na tabela no momento.

   É possível selecionar as colunas nas seguintes formas:

   • Selecione a tabela e obtenha a consulta padrão para todas as colunas.
   • Selecione as colunas para obter somente essas colunas.
7. Opcional: Modifique os valores de enumeração que são configurados para Erro, Dados ausentes e Sem valor na página Informações sobre o Atributo.
   Modifique os valores para evitar qualquer sobreposição com valores legitimados que podem ser retornados de colunas da tabela de banco de dados.
8. Opcional: Clique em Testar na janela do navegador Java Database Connectivity (JDBC) para testar e modificar a instrução SQL.
   A janela Executar a instrução SQL é aberta.
   1. Digite ou modifique a instrução SQL no campo Instrução SQL.
   2. Clique em Executar para executar a instrução SQL.
      Os resultados são exibidos na área Resultados. Continue a modificar e testar a instrução até estar satisfeito com os dados que são retornados.
   3. Clique em OK para salvar a instrução, crie os atributos corretos e retorne à janela Informações de JDBC.
9. Opcional: Clique em Testar na janela Informações de JDBC para testar o grupo de atributos em um ambiente de agente mais realista. Para obter informações adicionais sobre como testar grupos de atributos de JDBC, consulte Testando Grupos de Atributos JDBC. Se você mudar a instrução JDBC durante esse teste, também deve ajustar os atributos de forma que haja um atributo por coluna retornado pela instrução JDBC, na ordem correta.
10. Opcional: É possível criar um filtro para limitar os dados retornados por esse grupo de atributos clicando em Avançado. Para obter informações adicionais sobre filtragem de dados de um grupo de atributos, consulte Filtrando Grupos de Atributos
11. Na página Informações de JDBC, na seção Sistemas Operacionais, selecione os sistemas operacionais e clique em Avançar. Consulte Especificando Sistemas Operacionais para obter informações sobre quais sistemas operacionais devem ser selecionados.
    Nota: Clique em Inserir Propriedade de Configuração para selecionar uma propriedade a ser inserida. Para obter mais informações, consulte (Customizando configuração do agente).
12. Na página Selecionar Atributos-chave, selecione os atributos-chave ou indique que esta origem de dados produz somente uma linha de dados. Para obter mais informações, consulte Selecionando Atributos-Chaves.
13. Se você deseja testar uma origem de dados que definiu anteriormente, na janela do Agent Editor, selecione Origens de Dados e selecione uma origem de dados JDBC. Na área Informações do Grupo de Atributos JDBC, clique em Testar. Para obter informações adicionais sobre teste, consulte Testando Grupos de Atributos JDBC.
14. Se desejar visualizar as seções de configuração que foram geradas automaticamente, clique na guia Inserir Propriedade de Configuração do Agent Editor.
    É possível alterar os rótulos ou valores padrão para essas propriedades para corresponder aos padrões que o usuário vê quando configuram inicialmente o agente.
15. Opcional: Conclua a página Informações do Atributo ; para obter detalhes, consulte Campos e Opções para Definir Atributos. Execute essa etapa se optou por criar manualmente a origem de dados JDBC sem clicar em Procurar na etapa 4.
    A origem de dados do Agent Builder JDBC suporta coletar dados da maioria dos tipos SQL. As informações da Tabela 2 descrevem o tipo de atributo que é criado pelo Navegador do JDBC quando ele detecta uma coluna de um desses tipos. Esses tipos de dados são os tipos suportados para uso com o agente de monitoramento.

    Tabela 2. Tipos de dados SQL suportados para uso com um agente de monitoramento

    Tipo de dados SQL	IBM Tivoli Monitoring atributo que é criado
    BIGINT	Esse tipo de dado é um valor de calibrador de 64 bits no IBM Tivoli Monitoring. Se você selecionar a compatibilidade IBM Tivoli Monitoring V6.2, ela terá um calibrador de 32 bits.
    DECIMALDOUBLEFLOATNUMERICREAL	Esses Tipos de SQL são criados como atributos de calibrador de 64 bits no IBM Tivoli Monitoring. Se os metadados do banco de dados contiverem um valor escalar, esse valor será usado, caso contrário, a escala será configurada como 1. Se você selecionar a compatibilidade IBM Tivoli Monitoring V6.2, o atributo será um calibrador de 32 bits.
    BITINTEGERSMALLINTTINYINT	Os tipos de SQL a seguir são criados como atributos de calibrador de 32 bits no IBM Tivoli Monitoring.
    BOOLEAN	Este valor é um calibrador de 32 bits em IBM Tivoli Monitoring com enumerações para TRUE e FALSE.
    TIMESTAMP	Os dados nas colunas desse tipo são convertidos em um atributo de registro de data e hora do IBM Tivoli Monitoring de 16 bits.
    TIMEDATECHARLONGVARCHARVARCHAR	Esses tipos SQL são todos tratados como atributos de cadeia pelo navegador. O tamanho da coluna é usado como o tamanho do atributo até 256, que é o tamanho padrão do atributo de cadeia para o navegador do JDBC.

    Nota: Se você coletar dados a partir de um tipo de dados que não estiver listado, um atributo de cadeia será usado por padrão. O agente também tenta coletar os dados a partir do banco de dados como uma cadeia.

    Modifique os valores de enumeração que são configurados para Erro, Dados ausentes e Sem valor na página Informações sobre o Atributo, se necessário. Modifique os valores para evitar qualquer sobreposição com valores legitimados que podem ser retornados de colunas da tabela de banco de dados.