Tarefa Transferir Mensagens de Erro

A tarefa Transferir Mensagens de Erro transfere uma ou mais mensagens de erro do SQL Server definidas pelo usuário entre instâncias do SQL Server. Mensagens definidas pelo usuário são mensagens com um identificador igual ou maior que 50000. Mensagens com identificador menor que 50000 são mensagens de erro do sistema e não podem ser transferidas usando-se a tarefa Transferir Mensagens de Erro.

A tarefa Transferir Mensagens de Erro pode ser configurada para transferir todas as mensagens de erro ou só as mensagens de erro especificadas. Mensagens de erro definidas pelo usuário podem estar disponíveis em vários idiomas diferentes e a tarefa pode ser configurada para só transferir mensagens em idiomas selecionados. Uma versão us_english da mensagem, que usa a página de código 1033, deve estar no servidor de destino para que você possa transferir versões em outro idioma da mensagem para esse servidor.

A tabela sysmessages no banco de dados mestre contém todas as mensagens de erro, tanto as de sistema como as definidas pelo usuário, que o SQL Server usa.

As mensagens definidas pelo usuário a serem transferidas já podem existir no destino. Uma mensagem de erro estará definida como mensagem de erro duplicada se o identificador e o idioma forem os mesmos. A tarefa Transferir Mensagens de Erro pode ser configurada para controlar mensagens de erro da seguinte maneira:

  • Substituir mensagens de erro existentes.

  • Interromper a tarefa quando houver mensagens duplicadas.

  • Ignorar mensagens de erro duplicadas.

No tempo de execução, a tarefa Transferir Mensagens de Erro conecta-se aos servidores de origem e de destino usando um ou dois gerenciadores de conexões SMO. O gerenciador de conexões SMO é configurado separadamente da tarefa Transferir Mensagens de Erro e, depois, é consultado na tarefa Transferir Mensagens de Erro. O gerenciador de conexões SMO especifica o servidor e o modo de autenticação a serem usados ao acessar o servidor. Para obter mais informações, consulte Gerenciador de conexões SMO.

Transferindo entre instâncias do SQL Server

A tarefa Transferir Mensagens de Erro tem suporte a uma origem e um destino que sejam um SQL Server 2000 ou um SQL Server. Não há nenhuma restrição quanto à versão a ser usada como origem ou destino.

Eventos

A tarefa gera um evento de informações que informa o número de mensagens de erro que foram transferidas.

A tarefa Transferir Mensagens de Erro não informa o progresso incremental da transferência de mensagem de erro; informa somente conclusão 0% e 100 %.

Valor de execução

O valor de execução, definido na propriedade ExecutionValue da tarefa retorna o número de mensagens de erro que foram transferidas. Ao atribuir uma variável definida pelo usuário à propriedade ExecValueVariable da tarefa Transferir Mensagens de Erro, as informações sobre a mensagem de erro podem ser disponibilizadas para outros objetos no pacote. Para obter mais informações, consulte Variáveis do Integration Services e Usando variáveis em pacotes.

Entradas de log

A tarefa Transferir Mensagens de Erro inclui as seguintes entradas de log personalizadas:

  • TransferErrorMessagesTaskStartTransferringObjects   Essa entrada de log informa que a transferência foi iniciada. A entrada do log contém a hora de início.

  • TransferErrorMessagesTaskFinishedTransferringObjects    Essa entrada de log informa que a transferência foi concluída. A entrada do log contém a hora de término.

Além disso, uma entrada de log para o evento OnInformation informa o número de mensagens de erro transferidas e uma entrada de log para OnWarning event é gravada para cada mensagem de erro no destino que for substituído.

Segurança e permissões

Para criar novas mensagens de erro, o usuário que executa o pacote deve ser um membro do sysadmin ou ter função de servidor serveradmin no servidor de destino.

Configurando a Transferir Mensagens de Erro

Você pode definir propriedades com o Designer SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no Designer do SSIS, clique em um dos seguintes tópicos:

Para obter mais informações sobre como definir essas propriedades no Designer SSIS, clique no seguinte tópico:

Configurando programaticamente a Tarefa Transferir Mensagens de Erro

Para obter mais informações sobre como definir programaticamente essas propriedades, clique no seguinte tópico:

Ícone do Integration Services (pequeno) 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:

Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.