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 Expressões do SSIS (Integration Services), Usar expressões de propriedade em pacotes e Propriedades personalizadas de Transformação.

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

Log

Você poderá fazer log das chamadas que a transformação Comando OLE DB fizer a provedores de dados externos. Você pode usar esse recurso de log para solucionar problemas de conexões e comandos das fontes de dados externos executados pela transformação Comando OLE DB. Para fazer log das chamadas que a transformação Comando OLE DB fizer aos provedores de dados externos, habilite o log do pacote e selecione o evento Diagnóstico no nível de pacote. Para obter mais informações, consulte Solucionando problemas de ferramentas para execução de pacotes.

Tarefas relacionadas

Você pode configurar a transformação por meio do SSIS Designer ou do modelo de objeto. Para obter detalhes sobre como configurar a transformação por meio do SSIS Designer, consulte Configurar a transformação Comando OLE DB. Consulte o Guia do Desenvolvedor para obter detalhes sobre como configurar essa transformação programaticamente.

Conteúdo relacionado

Consulte também

Conceitos

Fluxo de dados

Transformações do Integration Services