Tarefa 3: Adicionando redirecionamento de fluxo de erro

Conforme mostrado na tarefa anterior, a transformação Pesquisa de Códigos de Moeda não pode gerar uma correspondência quando a transformação tenta processar o arquivo simples de amostra corrompido que produziu um erro. Como a transformação usa as configurações padrão da saída de erro, qualquer erro faz a transformação falhar. Quando a transformação falha, o resto do pacote também falha.

Em vez de permitir a falha da transformação, você pode configurar o componente para redirecionar a linha com falha para outro caminho de processamento usando a saída de erro. O uso de um caminho de tratamento separado de erro permite que você faça várias coisas. Por exemplo, você pode tentar limpar os dados e depois reprocessar a linha com falha. Também é possível salvar a linha com falha junto com informações de erro adicionais para verificação e reprocessamento posteriores.

Nesta tarefa, você configurará a transformação Pesquisa de Códigos de Moeda para redirecionar linhas com falha para a saída de erro. Na ramificação de erro do fluxo de dados, essas filas serão gravadas em um arquivo.

Por padrão as duas colunas extras em uma saída de erro do Integration Services, ErrorCode e ErrorColumn, só contêm códigos numéricos que representam um número de erro e a ID da coluna na qual o erro aconteceu. Esses valores numéricos podem ser de uso limitado sem a descrição de erro correspondente.

Para aumentar a utilidade da saída de erro, antes de o pacote gravar as linhas com falha no arquivo, você usará um componente Script para acessar a API do Integration Services e obter uma descrição do erro.

Para configurar uma saída de erro

1. Na Caixa de Ferramentas, expanda Transformações de Fluxo de Dados e depois arraste o Componente Script para a superfície de design da guia Fluxo de Dados. Coloque Script à direita da transformação Pesquisa de Códigos de Moeda.

2. Na caixa de diálogo Selecionar Tipo de Componente do Script, clique em Transformação e clique em OK.

3. Clique na transformação Pesquisa de Códigos de Moeda e depois arraste a seta vermelha sobre a transformação Scripts adicionada recentemente para conectar os dois componentes.

   A seta vermelha representa a saída de erro da transformação Pesquisa de Códigos de Moeda. Usando a seta vermelha para conectar a transformação ao componente Script, você pode redirecionar qualquer erro de processamento ao componente Script, que então processará os erros e os enviará ao destino.

4. Na caixa de diálogo Configurar Saída de Erro, na coluna Erro, selecione Redirecionar linha e, em seguida, clique em OK.

5. Na superfície de design de Fluxo de Dados, clique em Componente Script, no recém-adicionado ComponenteScript, e altere o nome para Obter Descrição de Erro.

6. Clique duas vezes na transformação Obter Descrição do Erro.

7. Na caixa de diálogo Editor de Transformação Scripts, na página Colunas de Entrada, selecione a coluna ErrorCode.

8. Na página Entradas e Saídas, expanda Saída 0, clique em Colunas de Saída e clique em Adicionar Coluna.

9. Na propriedade Name, digite ErrorDescription e defina a propriedade DataType como cadeia de caracteres [DT_WSTR].

10. Na página Script, verifique se a propriedade LocaleID está definida como Inglês (Estados Unidos).

11. Clique em Editar Script para abrir o MicrosoftVisual Studio Tools for Applications (VSTA). No método Input0_ProcessInputRow, digite ou cole o código a seguir.

    [Visual Basic]

      Row.ErrorDescription = 
        Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode)
    

    [Visual C#]

    Row.ErrorDescription = this.ComponentMetaData.GetErrorDescription(Row.ErrorCode);
    

    A sub-rotina concluída se parecerá com o código a seguir.

    [Visual Basic]

    Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer)
    
      Row.ErrorDescription = 
        Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode)
    
    End Sub
    

    [Visual C#]

    public override void Input0_ProcessInputRow(Input0Buffer Row)
        {
    
            Row.ErrorDescription = this.ComponentMetaData.GetErrorDescription(Row.ErrorCode);
    
        }
    

12. Crie o script para salvar suas alterações e depois feche o VSTA.

13. Clique em OK para fechar a caixa de diálogo Editor de Transformação Scripts.

Próxima tarefa na lição

Tarefa 4: Adicionando um destino de arquivo simples

Fique atualizado com o Integration Services Para obter os mais recentes downloads, artigos, exemplos e vídeos da Microsoft, bem como soluções selecionadas da comunidade, visite a página do Integration Services no MSDN ou TechNet: Visite a página do Integration Services no MSDN Visite a página do Integration Services no TechNet Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.