Etapa JDBC

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 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 JDBC executado somente em um ServiceNow® MID Server com Etapa JDBC. Ativar o plug-in, IntegrationHub Instalador de pacote padrão (com.glide.hub.integrations.standard) ou posterior para usar a capacidade JDBC para o. MID Server.

    Funções e disponibilidade

    . Etapa JDBC está disponível como Workflow Studio etapa de 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 em injeção de SQL no banco de dados de destino. Quando você usa cápsulas de dados em Etapa JDBC Instruções SQL, limpe-as primeiro usando Limpe 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 de instrução SQL.

    Lista de inclusão de operações SQL

    Por padrão, você pode executar as seguintes operações SQL.
    • SELECIONE
    • INSERIR
    • ATUALIZAR
    • DELETE
    • MOSTRAR
    • DESCREVA
    Para habilitar somente algumas dessas operações SQL, que Etapa JDBC pode 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:
    Não são permitidas várias instruções SQL. Não há suporte para procedimentos armazenados com parâmetros de saída.

    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 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 mudarem, 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. Os usuários com a função flow_designer ou admin 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 (criptografia de 2 vias) no painel de dados. Este campo estará disponível quando Usar alias de conexão Está selecionado na lista de Conexões.
    Alias de credencial Alias de credencial que o sistema usa para executar a etapa de ação. Os usuários com a função flow_designer ou admin podem criar ou selecionar um registro de conexão associado. O uso de 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 (criptografia de 2 vias) no painel de dados. Este campo estará disponível quando Defina a conexão em linha Está selecionado na lista de Conexões.
    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 ServiceNow a instância seleciona o. MID Server sem entrada manual.
    • MID Server específico : Seu ServiceNow usos da instância MID Server que você especificar.
    • MID Cluster específico : Seu ServiceNow A instância usa o cluster DO MID que você especificar.

      Um cluster DO MID é um grupo de MID Servers que habilita seu ServiceNow instâ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 estará disponível quando Defina a conexão em linha Está selecionado na lista de Conexões.
    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 estará disponível quando Defina a conexão em linha Está selecionado na lista de conexões 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 estará disponível quando Defina a conexão em linha Está selecionado na lista de conexões e. Personalizado É selecionado na lista Tipo de banco de dados.
    Aplicação de MID . MID Server deve ser compatível para ser elegível para a seleção. Este campo estará disponível quando Defina a conexão em linha Está selecionado na lista de Conexões.
    Capacidades Capacidade do MID Server. Selecione JDBC . Este campo estará disponível quando Defina a conexão em linha Está selecionado na lista de Conexões.
    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 estará disponível quando Defina a conexão em linha Está selecionado na lista de Conexões.
    Nota:
    Evite definir o valor de Tempo limite de conexão como 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 estará disponível quando Defina a conexão em linha Está selecionado na lista de Conexões.
    Configuração do JDBC
    Declaração SQL Instrução SQL executada pela etapa.
    Nota:
    Ao usar pílulas 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 .
    Tamanho máximo da carga (KB) Tamanho máximo permitido da carga, 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 Etapa JDBC de teste. Para obter mais informações, consulte Etapa JDBC de teste.
    Tentar Política Novamente
    Habilitar políticas de novas tentativas Opção para habilitar a política de novas tentativas. Para obter mais informações, consulte Política de novas tentativas .
    Substituir política padrão para alias Opção para substituir a política de novas tentativas padrão. Esta opção não é aplicável quando Defina a conexão em linha Está selecionado na lista de Conexões.
    Tentar Política Novamente Política de novas tentativas padrão associada a. Alias de conexão . Se Substituir política padrão para alias estiver selecionado, você pode substituir a política de novas tentativas padrão e selecionar outra política de novas tentativas existente com base em seu requisito.

    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.