Etapa JDBC

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 IntegrationHub. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub. 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 recursos Etapa JDBC. Ative o plug-in IntegrationHub Standard Pack Installer (com.glide.hub.integrations.standard) ou posterior para usar o recurso JDBC para o MID Server.

    Funções e disponibilidade

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

    Limpando entradas

    Escapa 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 instruções SQL Etapa JDBC, 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 da 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
    • DESCREVA
    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 usado.
    • 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 de administrador ou flow_designer 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 forem alteradas, 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 bidirecionalmente) 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 de administrador ou flow_designer 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 forem alteradas, 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 bidirecionalmente) no painel de dados. Este campo está disponível quando Definir conexão em linha é selecionado na lista Conexão.
    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 é Personalizada. Este campo está disponível quando Definir 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 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 MID Aplicação que 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ão.
    Capacidades Capacidade do MID Server. SelecioneJDBC. Este campo está disponível quando Definir 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 Definir conexão em linha é selecionado na lista Conexão.
    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ão.
    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 Limpar 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 permitido da carga, em KB, a ser retornado da instrução SQL. O tamanho da carga padrão é de 5120 KB. O tamanho máximo da carga é de 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 Testar JDBC.
    Política de nova tentativa
    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 Conexão.
    Política de nova tentativa 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.

    Campos de avaliação de erro de ação

    Campo Descrição
    Se esta etapa falhar 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 Action error evaluation.