Etapa JDBC

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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 Integration Hub. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do Integration Hub. Depois que o plug-in necessário for ativado, a etapa ficará visível em Integrações.
    • O Etapa JDBC é executado somente em um ServiceNow® MID Server com capacidades Etapa JDBC. Ative o plug-in Integration Hub Standard Pack Installer (com.glide.hub.integrations.standard) ou posterior para usar a capacidade JDBC para o MID Server.

    Funções e disponibilidade

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

    Limpeza de entradas

    Escape 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. Ao usar cápsulas de dados em Etapa JDBC instruções SQL, limpe-as primeiro usando as funções de transformação Limpar SQL. Esta categoria de função de transformação aparece automaticamente quando uma cápsula de dados é solta na entrada Instrução SQL.

    Lista de inclusões de operações SQL

    Por padrão, você pode executar as seguintes operações SQL.
    • SELECIONAR
    • INSERT
    • UPDATE
    • DELETE
    • MOSTRAR
    • DESCREVER
    Para habilitar somente algumas dessas operações SQL que o Etapa JDBC pode executar, crie uma propriedade [ MID Server, mid.property.jdbc_operations e insira as operações SQL, separadas por vírgula. Para saber mais sobre as propriedades MID Server, consulte Propriedades do MID Server.

    Campos

    Campo Descrição
    Detalhes da Conexão
    Conexão Tipo de conexão a ser usada.
    • Definir 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 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 (criptografada bidirecional) 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 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 (criptografada bidirecional) no painel de dados. Este campo está disponível quando Definir conexão em linha é selecionado na lista Conexões.
    Seleção de MID Opção para selecionar o MID Server ou Cluster do MID específico.
    • Seleção automática do MID Server: seleciona o MID Server automaticamente.
    • MID Server específico: usa o MID Server selecionado.
    • Cluster do MID específico: usa o Cluster do MID selecionado.
    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 Definir conexão em linha é selecionado na lista 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 está disponível quando Definir 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 Definir conexão em linha é selecionado na lista Conexão e Personalizado é selecionado na lista Tipo de banco de dados.
    Aplicação de MID Aplicação à qual o MID Server deve oferecer suporte para estar qualificado para seleção. Este campo está disponível quando Definir conexão em linha é selecionado na lista Conexões.
    Capacidades Capacidade do MID Server. SelecioneJDBC. Este campo está disponível quando Definir conexão em linha é selecionado na lista 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 está disponível quando Definir conexão em linha é selecionado na lista Conexões.
    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 Definir conexão em linha é selecionado na lista Conexões.
    Configuração do JDBC
    Instruções SQL Instrução SQL que a etapa executa.
    Nota:
    Ao usar cápsulas de dados em instruções SQL de etapa, limpe-as primeiro usando uma etapa de scriptde pré-processamento. Para obter mais informações, consulte Limpeza de 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 de carga permitido, em KB, a ser retornado da instrução SQL. O tamanho da carga padrão é 5120 KB. O tamanho máximo da carga é de 10 MB.
    Testar Etapa do JDBC Teste a etapa JDBC. Exiba os resultados de testes diretamente na janela Testar etapa JDBC. Para obter mais informações, consulte Etapa de teste JDBC.
    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 Definir conexão em linha é selecionado na lista de Conexões.
    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.