Fonte de dados do tipo JDBC

Uma fonte de dados JDBC recupera seus dados por meio de um driver JDBC, geralmente rede tipo 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 dentro do 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 a fonte de dados JDBC

As fontes de dados JDBC oferecem suporte a vários formatos e portas de banco de dados.

Tabela 1. Formatos de banco de dados compatíveis

Tipo de SQL Server	Porta
MySQL	3306
Microsoft SQL Server	1433
Oracle	1521

Nota:

Os campos Oracle DATE são carregados como campos de Data/Hora da ServiceNow.

Requisitos da declaraçã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 seja autenticado com o SQL Server.

A caixa de seleção Usar autenticação integrada no formulário de 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 de fonte de dados, a integração deve atender a estes critérios:

• O MID Server deve estar sendo executado em um computador Windows com SQL Server.
• O serviço do MID Server deve usar as mesmas credenciais que o SQL Server requer.
• O tipo de fonte de dados é JDBC.
• A caixa de seleção Usar MID Server da fonte de dados está marcada.
• O formato da fonte de dados é 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 do MID Server deve ter direitos de leitura no banco de dados do SCCM.

Figura 1. Formulário de fontes de dados

Nota:

O campo Banco de dados da última execução na fonte de dados JDBC faz distinção entre maiúsculas e minúsculas para o SQL Server.

Como adicionar drivers JDBC para formatos de banco de dados sem suporte

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

Adicionar uma nova opção de formato JDBC

Estenda as opções de driver JDBC disponíveis criando uma nova entrada na 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 campo Formato na tabela sys_data_source.

Procedimento

1. Navegue até System Import Sets > Administração > Fontes de dados.
2. Clique em Nova.
3. No formulário Fontes de dados, clique com o botão direito do mouse no rótulo do campo Formato e selecione Mostrar lista de seleção no menu pop-up.

   

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.
   Consulte os drivers existentes para obter exemplos.
   • Tabela: sys_data_source
   • Rótulo: nome do banco de dados que aparece como uma opção na lista de seleção Formato, por exemplo: Teradata.
   • Valor: 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. Essas informações geralmente estão disponíveis na documentação do fornecedor, como para MariaDB ou Teradata.
   • Valor dependente: JDBC

   

6. Clique em Enviar.

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

Adicionar opções de formato Sybase ou DB2 JDBC

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 os drivers Sybase ou DB2 JDBC, 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 Sybase ou DB2 JDBC para se conectar com 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 implementação do driver.

Procedimento

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

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

Instalar 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.
   • Origem: local do arquivo JAR para 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.

   

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.

Criar uma nova 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é Todos > Conjuntos de importação do sistema > Administração > Fontes de dados e clique em Novo.
2. No formulário Fonte de dados, selecione JDBC na lista do campo Tipo.
3. Selecione a nova fonte de dados na lista de seleção do campo Formato.

   

4. Configurar o layout do formulário e adicionar o campo URL de conexão.
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.