Você pode ativar a porta de saída NumRowsAffected para retornar o número de linhas afetadas pelas instruções de consulta INSERT, UPDATE ou DELETE em cada linha de entrada. O Serviço de Integração retorna o NumRowsAffected para cada instrução da consulta. O NumRowsAffected está desabilitado por padrão.
Quando você ativa NumRowsAffected no modo de consulta, e a consulta SQL não contém uma instrução INSERT, UPDATE ou DELETE, NumRowsAffected é zero em cada linha de saída.
Quando você ativa NumRowsAffected e a transformação está configurada para executar no modo de script, NumRowsAffected é sempre NULL.
A tabela a seguir lista as linhas de saída geradas pela transformação SQL quando você ativa o NumRowsAffected no modo de consulta:
Apenas UPDATE, INSERT, DELETE | Uma linha para cada instrução com o NumRowsAffected referente à instrução. |
Uma ou mais instruções SELECT | Número total de linhas recuperadas do banco de dados. NumRowsAffected é zero em cada linha. |
Consultas DDL, como CREATE, DROP, TRUNCATE | Uma linha com NumRowsAffected zero. |
Quando a transformação SQL executa no modo de consulta e uma consulta contém múltiplas instruções, o Serviço de Integração retorna o NumRowsAffected para cada instrução. NumRowsAffected contém a soma das linhas afetadas por cada instrução INSERT, UPDATE e DELETE em uma linha de entrada.
Por exemplo, uma consulta contém as seguintes instruções:
DELETE from Employees WHERE Employee_ID = ‘101’;
SELECT Employee_ID, LastName from Employees WHERE Employee_ID = ‘103’;
INSERT into Employees (Employee_ID, LastName, Address)VALUES (‘102’, 'Gein', '38 Beach Rd')
A instrução DELETE afeta uma linha. A instrução SELECT não afeta nenhuma linha. A instrução INSERT afeta uma linha.
O Serviço de Integração retorna uma linha a partir da instrução DELETE. NumRowsAffected é igual a um. Retorna uma linha a partir da instrução SELECT e NumRowsAffected é zero. Retorna uma linha a partir da instrução INSERT, com NumRowsAffected igual a um.
A porta NumRowsAffected retorna zero quando todas as seguintes condições forem verdadeiras:
O banco de dados é Informix.
A transformação está executando no modo de consulta.
A consulta não contém parâmetros.