Etapa JDBC

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

Nota:

• Esta etapa requer um Integration Hubassinatura. Para obter mais informações, consulte Cronogramas jurídicos - Integration Hubvisã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 Servercom Etapa JDBC. Ativar o plug-in, Integration HubInstalador 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 JDBCestá disponível como Workflow Studioetapa 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 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 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 JDBCpode executar, criar um MID Serverpropriedade, mid.property.jdbc_operationsE insira as operações SQL, separadas por vírgula. Para saber mais sobre MID Serverpropriedades, consulte Propriedades do MID Server .

Nota:

Várias instruções SQL não são permitidas. 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 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. O uso de 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. O uso de 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 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 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 é MID Serverusa 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 Serverdeve ser compatível para ser elegível para 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
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 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 Testar etapa JDBC. 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 Action error evaluation.