Etapa JDBC

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

    • Crie uma ação reutilizável para enviar comandos SQL para um banco de dados relacional.

    Nota:
    • Esta etapa exige uma assinatura IntegrationHub. Para obter mais informações, consulte Cronogramas jurídicos - IntegrationHub visão geral . Depois que o plug-in necessário for ativado, a etapa ficará visível em Integrações.
    • . Etapa JDBCexecutado somente em um ServiceNow® MID Server com Etapa JDBC. Ativar o plug-in, IntegrationHub Standard Pack Installer (com.glide.hub.integrations.standard) ou posterior para usar o recurso JDBC para MID Server.

    Funções e disponibilidade

    . Etapa JDBCestá disponível como Workflow Studio etapa da ação. Usuários com a função action_designer podem criar uma ação personalizada com uma ou mais etapas de ação.

    Limpando entradas

    Escape de todas as entradas do usuário para eliminar a possibilidade de um usuário mal-intencionado executar instruções SQL mal-intencionadas que podem resultar na injeção de SQL no banco de dados de destino. Quando você usa cápsulas de dados em Etapa JDBCInstruções SQL, limpe-as primeiro usando Limpar funções de transformação SQL . Esta categoria de função de transformação aparece automaticamente quando uma cápsula de dados é descartada na entrada Instrução SQL.

    Lista de inclusão de operações SQL

    Por padrão, você pode executar as seguintes operações SQL.
    • SELECIONE
    • INSERT
    • UPDATE
    • DELETE
    • MOSTRAR
    • DESCREVA
    Para habilitar somente algumas dessas operações SQL, use Etapa JDBCpode executar, criar um MID Server propriedade, mid.property.jdbc_operationsE insira as operações SQL, separadas por vírgula. Para saber mais sobre MID Server propriedades, consulte Propriedades do MID Server .
    Nota:
    Várias instruções SQL não são permitidas. Procedimentos armazenados com parâmetros de saída não são compatíveis.

    Campos

    Campo Descrição
    Detalhes da Conexão
    Conexão Tipo de conexão a ser usada.
    • Defina a conexão em linha : Defina as informações de conexão na etapa de ação.
    • Usar Alias de Conexão : Defina as informações de conexão usando a tabela de alias de conexão. Usar um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar uma ação em vários ambientes. Da mesma forma, se as informações de conexão forem alteradas, você não precisará atualizar sua ação personalizada.

    Para saber mais sobre conexões e credenciais, consulte Introdução a credenciais, conexões e aliases .
    Alias de conexão Registro de alias de conexão e credencial que o sistema usa para executar a etapa de ação. Usuários com a função flow_designer ou administrador podem criar ou selecionar um registro de conexão associado. Usar um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar uma ação em vários ambientes. Da mesma forma, se as informações de conexão mudarem, você não precisará atualizar sua ação personalizada. Para saber mais sobre conexões e credenciais, consulte credenciais, conexões e aliases . O valor da credencial é exibido como uma cápsula de dados de senha (criptografada em 2 vias) no painel de dados. Este campo está disponível quando Usar Alias de Conexão Selecionado na lista Conexão.
    Alias de credencial Alias de credencial que o sistema usa para executar a etapa de ação. Usuários com a função flow_designer ou administrador podem criar ou selecionar um registro de conexão associado. Usar um alias elimina a necessidade de configurar várias credenciais ao usar uma ação em vários ambientes. Da mesma forma, se as informações de credencial mudarem, você não precisará atualizar sua ação personalizada. Para saber mais sobre conexões e credenciais, consulte credenciais, conexões e aliases . O valor da credencial é exibido como uma cápsula de dados de senha (criptografada em 2 vias) no painel de dados. Este campo está disponível quando Defina a conexão em linha Selecionado na lista Conexão.
    Seleção de MID 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 Definir conexão em linha é selecionado na lista Conexão.
    Cluster do MID Cápsula de dados para o cluster MID que você deseja usar. Este campo fica disponível quando Definir conexão em linha é selecionado na lista Conexão, Cluster MID específico estiver selecionado na lista Seleção de MID.
    Tipo de Banco de Dados Tipo de banco de dados para esta conexão. As opções são:
    • MySQL
    • Oracle
    • SQLServer
    • Personalizado
    A opção padrão é Personalizado . Este campo está disponível quando Defina a conexão em linha Selecionado na lista Conexão.
    Driver JDBC Driver a ser usado para esta conexão quando não for um tipo de banco de dados padrão, como DB2 Universal e Sybase. O tipo de banco de dados é Personalizado . Este campo está disponível quando Defina a conexão em linha É selecionado na lista Conexão e Personalizado É selecionado na lista Tipo de banco de dados.
    URL de conexão 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. Este campo está disponível quando Defina a conexão em linha É selecionado na lista Conexão e Personalizado É selecionado na lista Tipo de banco de dados.
    Aplicação de MID Que o MID Server suporte necessário para ser qualificado para seleção. Este campo está disponível quando Defina a conexão em linha Selecionado na lista Conexão.
    Capacidades Capacidade do MID Server. Selecione JDBC . Este campo está disponível quando Defina a conexão em linha Selecionado na lista Conexão.
    Tempo limite de conexão Tempo máximo decorrido, em segundos, para a atividade aguardar ao tentar se conectar ao banco de dados de destino. Este campo está disponível quando Defina a conexão em linha Selecionado na lista Conexão.
    Nota:
    Evite definir Tempo limite de conexão valor zero, pois isso pode causar uma conexão obsoleta.
    Tempo limite da consulta Tempo máximo decorrido, em segundos, que a consulta pode ser executada sem uma resposta. Este campo está disponível quando Defina a conexão em linha Selecionado na lista Conexão.
    Configuração do JDBC
    Instruções SQL Instrução SQL executada pela etapa.
    Nota:
    Ao usar cápsulas de dados em instruções SQL STEP, limpe-as primeiro usando um pré-processamento Etapa de script . Para obter mais informações, consulte Limpando entradas usando as funções de escape .
    Máximo de Linhas Número máximo de linhas a serem retornadas da instrução SQL. O valor padrão é 1000 .
    Tamanhos da Cargas Máximas (KB) Tamanho máximo da carga permitida, em KB, a ser retornado da instrução SQL. O tamanho da carga padrão é 5120 KB . O tamanho máximo da carga é 10 MB .
    Testar Etapa do JDBC Teste a etapa JDBC. Exiba os resultados do teste diretamente na janela Testar etapa JDBC. Para obter mais informações, consulte Etapa JDBC de teste.
    Tentar Política Novamente
    Habilitar políticas de novas tentativas para habilitar a política de nova tentativa. Para obter mais informações, consulte Política de nova tentativa.
    Substituir política padrão para alias Opção para substituir a política de nova tentativa padrão. Esta opção não é aplicável quando Defina a conexão em linha Selecionado na lista Conexão.
    Tentar Política Novamente Política de repetição padrão associada ao Alias de conexão. Se a opção Substituir política padrão para alias estiver selecionada, será possível substituir a política de nova tentativa padrão e selecionar outra política de nova tentativa existente com base em seus requisitos.

    Avaliação de erro de ação

    Se esta etapa falhar
    Tipo de dados: Choice

    Opção para continuar executando a próxima etapa ou ir para a avaliação de erro. Para usar o código de status da etapa ou a mensagem para uma condição de erro de ação personalizada, consulte Avaliação de erro de ação.