Transformação Comando OLE DB

A transformação Comando OLE DB executa uma instrução SQL para cada linha do fluxo de dados. Por exemplo, você pode executar uma instrução SQL que insira, atualize ou exclua linhas em uma tabela de banco de dados.

É possível configurar a transformação Comando OLE DB com os seguintes procedimentos:

• Forneça a instrução SQL que a transformação executa para cada linha.

• Especifique o número de segundos antes que a instrução SQL expire.

• Especifique a página de código padrão.

Normalmente, a instrução SQL inclui parâmetros. Os valores de parâmetro são armazenados em colunas externas na entrada da transformação e o mapeamento de uma coluna de entrada para uma coluna externa mapeia uma coluna de entrada para um parâmetro. Por exemplo, para localizar linhas na tabela DimProduct pelo valor da coluna ProductKey e, em seguida, excluí-las, você pode mapear a coluna externa nomeada como Param_0 para a coluna de entrada nomeada como ProductKey e, em seguida, executar a instrução SQL DELETE FROM DimProduct WHERE ProductKey = ?. A transformação Comando OLE DB fornece os nomes de parâmetro e você não pode modificá-los. Os nomes de parâmetro são Param_0, Param_1 e assim por diante.

Se você configurar a transformação Comando OLE DB usando a caixa de diálogo Editor Avançado, os parâmetros na instrução SQL poderão ser mapeados automaticamente para colunas externas na entrada da transformação e as características de cada parâmetro poderão ser definidas, clicando no botão Atualizar. Entretanto, se o provedor OLE DB que a transformação Comando OLE DB usa não oferecer suporte para derivação de informações do parâmetro, você deverá configurar as colunas externas manualmente. Isto significa que você deve adicionar uma coluna para cada parâmetro na entrada externa para a transformação, atualizar os nomes de coluna para usar nomes como Param_0, especificar o valor da propriedade DBParamInfoFlags e mapear as colunas de entrada que contêm valores de parâmetro para as colunas externas.

O valor da propriedade DBParamInfoFlags representa as características do parâmetro. Por exemplo, o valor 1 especifica que o parâmetro é de entrada e o valor 65 especifica que o parâmetro é de entrada e pode conter um valor nulo. Os valores devem corresponder aos da enumeração OLE DB DBPARAMFLAGSENUM. Para obter mais informações, consulte a documentação de referência do OLE DB.

A transformação Comando OLE DB inclui a propriedade personalizada SQLCommand. Essa propriedade poderá ser atualizada por uma expressão de propriedade quando o pacote for carregado. Para obter mais informações, consulte Referência de Expressão do Integration Services, Usando expressões de propriedade em pacotes e Propriedades personalizadas de Transformação.

Essa transformação tem uma entrada, uma saída regular e uma saída de erro.