Fonte de dados do tipo JDBC

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Uma fonte de dados JDBC recupera seus dados por meio de um driver JDBC, geralmente tipo rede 4.

    A conexão JDBC está disponível diretamente na instância da ServiceNow (é necessária uma configuração de VPN) ou por meio de um MID Server dedicado instalado no firewall que pode acessar a porta do banco de dados.

    Nota:
    As chamadas JDBC do MID Server nunca são criptografadas. Limite os direitos disponíveis para o usuário DO MID Server sempre que fizer chamadas JDBC de um MID Server.

    Formatos de banco de dados compatíveis com fonte de dados JDBC

    As fontes de dados JDBC são compatíveis com vários formatos e portas de banco de dados.

    Tabela 1. Formatos de banco de dados compatíveis
    SQL Server Type Porta
    MySQL 3306
    Microsoft SQL Server 1433
    Oracle 1521
    Nota:
    Os campos DE DATA do Oracle são carregados como campos Data/hora da ServiceNow.

    Requisitos de instrução SQL da fonte de dados JDBC

    As consultas JDBC que executam instruções SQL devem especificar um nome de coluna.

    Por exemplo, esta consulta especifica o nome da coluna ServerId .
    SELECT DISTINCT 'server_name:' + CONVERT ( VARCHAR , lg .ResourceID ) AS 'ServerID' 
    ,LastHWScan
    ,Account0
    ,Category0
    Fromv_GS_WORKSTATION_STATUSsInner  JOIN
    v_GS_LocalGroupMembers0lg
    ON s .ResourceID  = lg .ResourceID
    WhereType0  = 'Local' AND Category0  = 'SystemAccount'

    Autenticação integrada do SQL Server para Windows

    Uma fonte de dados JDBC pode usar o ID de para que o usuário do serviço do Windows MID Server se autentique com o SQL Server.

    . Use autenticação integrada A caixa de seleção no formulário Fonte de dados determina se a fonte de dados JDBC usa as credenciais de usuário do serviço do MID Server. Para que este campo apareça no formulário Fonte de dados, a integração deve atender a estes critérios:

    • O MID Server deve estar em execução em um computador Windows com SQL Server.
    • O serviço do MID Server deve usar as mesmas credenciais que o SQL Server requer.
    • A fonte de dados Tipo É JDBC.
    • A fonte de dados Use o MID Server está marcada.
    • A fonte de dados Formato É SQLServer.
    Importante:
    Se a autenticação integrada for escolhida e você estiver integrando com o Microsoft System Center Configuration Manager, a conta que executa o serviço MID Server deve ter direitos de leitura no banco de dados do SCCM.
    Figura 1. Formulário de fontes de dados
    Formulário de fontes de dados
    Nota:
    . Último campo de banco de dados de execução Na fonte de dados JDBC faz distinção entre maiúsculas e minúsculas para o SQL Server.

    Adicionando drivers JDBC para formatos de banco de dados incompatíveis

    Use o procedimento a seguir para estender a fonte de dados para usar um driver para um banco de dados que não é fornecido no sistema de base. As conexões JDBC são compatíveis com os seguintes bancos de dados padrão:

    Adicione uma nova opção de formato JDBC

    Estenda as opções de driver JDBC disponíveis criando uma nova entrada de lista de seleção para especificar o nome do pacote Java do driver JDBC.

    Antes de Iniciar

    Função necessária: Import_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Adicione uma nova entrada de lista de seleção para o novo banco de dados ao Formato . sys_data_sourcetabela.

    Procedimento

    1. Navegue até Conjuntos para importação do sistema > Administração > Fontes de dados .
    2. Clique em Nova.
    3. No formulário Fontes de dados, clique com o botão direito do mouse em Formato rótulo do campo e selecione Mostrar Lista de Seleção no menu pop-up.
      Lista de origens JDBC
    4. Clique em Novo na lista de opções.
    5. Forneça os seguintes valores para criar a nova opção de banco de dados.
      Observe os drivers existentes para obter exemplos.
      • Tabela: sys_data_source
      • Nome do banco de dados que aparece como uma opção no Formato Lista de seleção, por exemplo: Teradata.
      • Nome do pacote e classe do driver. Por exemplo, o valor de Teradata é com.ncr.teradata.TeraDriver.
        Nota:
        O pacote e a classe do driver devem ser fornecidos pelo fornecedor do driver. Muitas vezes, essas informações estão disponíveis na documentação do fornecedor, como para MariaDB ou Teradata .
      • Valor dependente: JDBC
      Lista de seleção JDBC.
    6. Clique em Enviar.

      A nova fonte de dados agora aparece na lista de formatos JDBC disponíveis.

    Adicione opções de formato JDBC Sybase ou DB2

    Estenda as opções de driver JDBC disponíveis ativando as opções Sybase ou DB2.

    Antes de Iniciar

    Função necessária: administrador

    Importante:
    Para usar drivers JDBC Sybase ou DB2, você deve instalar manualmente o arquivo JAR do driver em um MID Server. Consulte KB0551236 para obter mais informações.

    Por Que e Quando Desempenhar Esta Tarefa

    Ative os drivers JDBC Sybase ou DB2 para se conectar a esses formatos de banco de dados por meio de um MID Server. Este procedimento pressupõe que você esteja usando os seguintes drivers Sybase ou DB2:
    Tabela 2. Drivers
    Formato Driver Classe do driver
    Sybase jconnect-jdbc com.sybase.jdbc3.jdbc.SybDriver
    DB2 db2jcc com.ibm.db2.jcc.DB2Driver

    Se você estiver usando uma implementação diferente do driver Sybase ou DB2, deverá modificar a opção Valor para usar a classe de driver da sua implementação de driver.

    Procedimento

    1. Navegue até Conjuntos para importação do sistema > Administração > Fontes de dados .
    2. Clique em Nova.
    3. Em Tipo campo, selecione JDBC .
    4. Clique com o botão direito do mouse em Formato rótulo do campo e selecione Configurar opções no menu pop-up.
    5. Mova o. Sybase ou DB2 Universal opções do Disponível coluna para Selecionado coluna.
    6. Clique em Salvar.

      A nova fonte de dados agora aparece na lista de formatos JDBC disponíveis.

    Instale um driver em um MID Server

    Você pode instalar um novo arquivo JAR do driver JDBC em um MID Server para acessar formatos de banco de dados que não são compatíveis por padrão.

    Antes de Iniciar

    Função necessária: agent_admin

    Procedimento

    1. Navegue até MID Server > Arquivos JAR .
    2. Clique em Nova.
    3. Preencha os seguintes campos:
      • Nome: Um nome exclusivo e descritivo para identificar o arquivo na instância.
      • Versão: Um número de versão do arquivo, se houver um disponível.
      • Origem: Local do arquivo JAR para fins de referência. As informações de origem não são usadas pelo sistema.
      • Descrição: Descrição resumida do arquivo JAR e sua finalidade na instância.
    4. Clique no ícone de clipe de papel na faixa e anexe o arquivo JAR ao registro.
      Anexar um arquivo
    5. Clique em Enviar.
    6. Reinicie o serviço do MID Server.

      A plataforma disponibiliza o arquivo JAR para qualquer MID Server configurado para se comunicar com a instância.

    Crie uma fonte de dados JDBC para um formato de banco de dados incompatível

    Adicione uma nova fonte de dados JDBC definindo um registro de fonte de dados.

    Antes de Iniciar

    Função necessária: Import_admin

    Procedimento

    1. Navegar até Tudo > Conjuntos para importação do sistema > Administração > Fontes de dados e clique em Novo .
    2. No formulário Fonte de dados, selecione JDBC na lista em Tipo campo.
    3. Selecione a nova fonte de dados na lista de seleção em Formato campo.
      Fonte de dados JDBC
    4. Configurar o layout do formulário e adicione URL de conexão campo.
    5. Forneça o URL de conexão para a fonte de dados JDBC e clique em Enviar .

      Nenhuma outra informação de conexão é necessária.

      Fonte de dados JDBC