Criar uma conexão JDBC

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • A Conexão JDBC fornece as informações que as atividades ou ações personalizadas JDBC usam para se conectarem a vários bancos de dados de destino.

    Antes de Iniciar

    Você deve ter um arquivo JAR apropriado, seja ele fornecido com a instância ou um arquivo JAR personalizado.
    Nota:
    A instância ServiceNow fornece arquivos mysql-connector-java-5.1.21.jar, sql-server-jdbc-4.0.jare ojdbc6.jar como parte da versão atual, que suporta bancos de dados MySQL, SQLServer e Oracle. Outros bancos de dados, como Sybase ou DB2 Universal, devem usar um arquivo JAR personalizado que deve ser carregado para a instância antes de definir a conexão JDBC.

    Função necessária: connection_admin

    Por Que e Quando Desempenhar Esta Tarefa

    As credenciais JDBC são recuperadas separadamente pelo modelo de designer de atividades e suportam o armazenamento externo de credenciais, tal como CyberArk.

    Procedimento

    1. Navegar até Tudo > Credenciais e Conexões > Conexõesclique em Novo e selecione Conexão JDBC .
    2. Preencha o formulário usando os campos da tabela.
      A seleção do banco de dados no campo Formato determina quais campos estão disponíveis.
      Tabela 1. Campos de conexão JDBC
      Campo Formato do banco de dados Descrição
      Nome Todos Nome exclusivo desta conexão JDBC. Por exemplo, você pode inserir JDBC MySQLProd.
      Credencial Todos Adicione credenciais para o provedor JDBC.
      Alias de conexão Todos Selecione o registro de alias a ser associado a esta conexão. Usar um alias permite que você atualize o registro de conexão sem precisar reconfigurar nenhuma ação ou atividade que use o alias.
      Tempo limite da consulta Todos Tempo máximo decorrido em que a consulta JDBC pode ser executada sem uma resposta.
      Tempo limite de conexão Tudo

      Número de segundos que o sistema aguarda antes de fechar uma conexão JDBC ou solicitação de conexão.

      Por exemplo, se o Tempo limite de conexão o valor é 10 segundos, o sistema aguarda 10 segundos para uma conexão bem-sucedida. Se uma conexão bem-sucedida não ocorrer durante esse tempo, a solicitação de conexão expirará. Se ocorrer uma conexão bem-sucedida, a conexão permanecerá aberta até que haja um período de inatividade de 10 segundos. Quando a conexão estiver inativa por 10 segundos, a conexão será encerrada.

      Nota:
      Evite definir Tempo limite de conexão valor zero, pois isso pode causar uma conexão obsoleta.
      Ativo Todos Marque a caixa para tornar esta uma conexão ativa.
      Domínio Todos Domínio desta tabela. Por padrão, a tabela Conexão JDBC [jdbc_connection] é executada no domínio global.
      Formato Todos Tipo de banco de dados para esta conexão. As opções padrão são:
      • MySQL
      • Oracle
      • SQLServer
      • Nenhum(a)
      É possível adicionar Sybase ou DB2 Universal à lista de seleção carregando o arquivo JAR do driver JDBC apropriado na instância. O Orquestração reconhece automaticamente esses drivers quando são carregados no sistema e os adiciona a esta lista.
      Host Oracle, MySQL, SQLServer Nome do host ou endereço IP do servidor do banco de dados.
      Oracle sid Oracle O identificador do site do banco de dados Oracle. O valor padrão é orcl.
      Porta Oracle Oracle Porta que o banco de dados Oracle está usando. O valor padrão é 1521.
      Nome do banco de dados MySQL, SQLServer Nome do banco de dados.
      Porta My SQL, SQLServer Porta que o banco de dados selecionado está usando.
      Nome da instância SQLServer Nome da instância do SQLServer selecionado
      URL de Conexão Todos URL que o MID Server usa para se conectar ao banco de dados especificado. O URL é criado automaticamente quando você salva o formulário e é somente leitura para os bancos de dados padrão.
      Nota:
      Se o formato selecionado não for um dos bancos de dados padrão, você deve criar o URL de conexão manualmente para que o MID Server saiba como criar a conexão.
      Driver JDBC Nenhum, DB2 Universal, Sybase O driver JDBC a ser usado para esta conexão quando não for um banco de dados padrão.
      Nota:
      Se você adicionar um banco de dados Sybase ou DB2 Universal, deve inserir o nome do driver neste campo e carregar o arquivo do driver JAR para a instância.
      Usar MID Server Todos Marque para usar um MID Server para esta ação ou atividade. Se selecionado, defina os campos na seção Configuração avançada do MID Server.
      Seleção de MID Todos Opção para selecionar um MID Server ou cluster DO MID específico. Escolha qualquer uma das opções a seguir.
      • MID Server de seleção automática : Seu ServiceNowa instância seleciona o. MID Serversem entrada manual.
      • MID Server específico : Seu ServiceNowusos da instância MID Serverque você especificar.
      • MID Cluster específico : Seu ServiceNowA instância usa o cluster DO MID que você especificar.

        Um cluster DO MID é um grupo de MID Servers que habilita seu ServiceNowinstância para lidar com várias integrações e melhorar a velocidade de integração. Para obter mais informações, consulte Configure a MID Server cluster.

      Este campo fica disponível quando Usar MID Server está marcado.
      Nota:
      Certifique-se de que o registro de conexão IntegrationHub seja referenciado, não um registro de conexão Orquestração.
      Recursos Todos

      Os recursos que MID Server deve oferecer suporte para serem qualificados para seleção. O sistema executa a ação ou atividade de um MID Server que oferece suporte aos recursos selecionados. Exibido somente se Usar MID Server estiver selecionado.

      Os recursos necessários determinam qual MID Server é selecionado no tempo de execução. Para saber mais sobre como um MID Server é selecionado durante o tempo de execução, consulte Seleção do MID Server. Este campo fica visível apenas quando Seleção automática do MID Server estiver selecionada na lista de Seleção MID.
      Aplicação MID Todos

      A aplicação que MID Server deve oferecer suporte para ser qualificado para seleção. O sistema executa a ação de um(a) MID Server que oferece suporte à aplicação selecionada. Exibido somente se Usar MID Server estiver selecionado.

      Para saber mais sobre como um(a) MID Server é selecionado durante o tempo de execução, consulte MID Server selection.

      MID Server Todos MID Server específico no qual a etapa é executada. Este campo fica visível apenas quando MID Server específico for selecionado da lista de Seleção MID.
      Cluster do MID Todos O Cluster do MID específico que você deseja usar. Este campo fica disponível quando Usar Mid Server está marcado e Cluster de MID específico estiver selecionado na lista Seleção de MID.
    3. Clique em Enviar.