Tarefa Transferir Mensagens de Erro

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

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 ser usado ao acessar o servidor. Para obter mais informações, consulte SMO Connection Manager.

A tarefa Transferir Mensagens de Erro dá suporte a uma origem e a um destino do 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 Mensagem de Erro, as informações sobre a transferência de mensagem de erro podem se tornar disponíveis a outros objetos no pacote. Para obter mais informações, confira Variáveis do Integration Services (SSIS) e Usar 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.

Configuração da tarefa Transferir Mensagens de Erro

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, clique no tópico a seguir:

• Página Expressões

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

• TransferErrorMessagesTask

Related Tasks

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

• Definir as propriedades de uma tarefa ou contêiner

Editor da Tarefa Transferir Mensagens de Erro (página Geral)

Use a página Geral da caixa de diálogo Editor da Tarefa Transferir Mensagens de Erro para nomear e descrever a 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.

Opções

Nome
Digite um nome exclusivo para a tarefa Transferir Mensagens de Erro. Esse nome é usado como rótulo no ícone de tarefa.

Descrição
Digite uma descrição para a tarefa Transferir Mensagens de Erro.

Editor da Tarefa Transferir Mensagens de Erro (página Mensagens)

Use a página Mensagens da caixa de diálogo Editor da Tarefa Transferir Mensagens de Erro para especificar as propriedades de cópia de uma ou mais mensagens de erro SQL Server definidas pelo usuário de uma instância do SQL Server para outra.

Opções

SourceConnection
Selecione um gerenciador de conexões SMO na lista ou clique em <Nova conexão...> para criar uma nova conexão com o servidor de origem.

DestinationConnection
Selecione um gerenciador de conexões do SMO na lista ou clique em <Nova conexão...> para criar uma conexão com o servidor de destino.

IfObjectExists
Selecione se a tarefa deve substituir mensagens de erro definidas pelo usuário existentes, ignorar mensagens existentes ou causar falha se mensagens de erro de mesmo nome já existirem no servidor de destino.

TransferAllErrorMessages
Selecione se a tarefa deve copiar todas ou somente as mensagens especificadas definidas pelo usuário do servidor de origem para o servidor de destino.

As opções desta propriedade estão listadas na seguinte tabela:

ErrorMessagesList
Clique no botão Procurar (...) para selecionar as mensagens de erro para copiar.

ErrorMessageLanguagesList
Clique no botão Procurar (...) para selecionar os idiomas para os quais copiar mensagens de erro definidas pelo usuário para o servidor de destino. Uma versão us_english (página de código 1033) da mensagem deve estar no servidor de destino para que seja possível transferir versões da mensagem em outro idioma para esse servidor.

Consulte Também

Tarefas do Integration Services
Fluxo de Controle