Message Queue Task

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

A Tarefa Fila de Mensagens permite usar o serviço de Enfileiramento de Mensagens (também conhecido como MSMQ) para enviar e receber mensagens entre pacotes do SQL Server Integration Services ou enviar mensagens a uma fila de aplicativos processada por um aplicativo personalizado. Essas mensagens podem adotar a forma de texto simples, arquivos ou variáveis e seus valores.

Usando a tarefa Fila de Mensagens, você pode coordenar operações em toda sua empresa. As mensagens podem ser enfileiradas e entregues mais tarde se o destino estiver indisponível ou ocupado; por exemplo, a tarefa pode enfileirar mensagens para o laptop offline de representantes de vendas que recebem suas mensagens quando se conectarem à rede. Você pode usar a tarefa Fila de Mensagens para os seguintes propósitos:

• Atrasar a execução da tarefa até que outros pacotes façam check-in. Por exemplo, depois de manutenção noturna em cada um de seus sites de varejo, uma tarefa Fila de Mensagens envia uma mensagem a seu computador corporativo. Um pacote que é executado no computador corporativo contém tarefas de Fila de Mensagens, cada uma esperando por uma mensagem de um site de varejo específico. Quando uma mensagem de um site chega, uma tarefa carrega dados daquele site. Depois que todos os sites fizerem check-in, o pacote computa os totais dos resumos.

• Enviando arquivos de dados ao computador que os processa. Por exemplo, a saída da caixa registradora de um restaurante pode ser enviada em uma mensagem de arquivo de dados ao sistema de folha de pagamento corporativo, onde os dados sobre as gorjetas de cada garçom são extraídos.

• Distribuindo arquivos para toda a sua empresa. Por exemplo, um pacote pode usar uma tarefa de Fila de Mensagens para enviar um arquivo de pacote a outro computador. Um pacote que é executado no computador de destino usa então uma tarefa de Fila de Mensagens para recuperar e salvar o pacote localmente.

Quando estiver enviando ou recebendo mensagens, a tarefa Fila de Mensagens usa um dos quatro tipos de mensagem: arquivo de dados, cadeia, mensagem de cadeia a variável, ou variável. O tipo de mensagem “mensagem de cadeia de caracteres para variável” só pode ser usada ao receber mensagens.

A tarefa usa um gerenciador de conexões MSMQ para se conectar à uma fila de mensagens. Para obter mais informações, consulte Gerenciador de Conexão do SMO. Para obter mais informações sobre o serviço de enfileiramento de mensagens, consulte a MSDN Library.

A tarefa Fila de Mensagens requer que o serviço Integration Services esteja instalado. Alguns componentes do SQL Server que você pode selecionar para instalação na página Componentes a Serem Instalados ou na página Seleção de Recursos do Assistente de Instalação SQL Server instalam um subconjunto parcial de componentes do Integration Services . Esses componentes são úteis para tarefas específicas, mas a funcionalidade do Integration Services será limitada. Por exemplo, a opção SQL Server Data Tools (SSDT) instala os componentes Integration Services necessários para projetar um pacote, mas o serviço Integration Services não é instalado e, portanto, a tarefa Fila de Mensagens não é funcional. Para assegurar uma instalação completa de Integration Services, você deve selecionar Integration Services na página Componentes a Serem Instalados . Para obter mais informações sobre como instalar e executar a tarefa Fila de Mensagens, consulte Instalar o Integration Services.

Tipos de mensagem

Você pode configurar os tipos de mensagem que a tarefa Fila de Mensagens oferece dos seguintes modos:

• A mensagemData file especifica que um arquivo contém a mensagem. Ao receber mensagens, você pode configurar a tarefa para gravar o arquivo, pode substituir um arquivo existente e pode especificar o pacote do qual a tarefa pode receber mensagens.

• A mensagemString especifica a mensagem como uma cadeia de caracteres. Ao receber mensagens, você pode configurar a tarefa para comparar a cadeia de caracteres recebida com uma cadeia de caracteres definida pelo usuário e entrar em ação dependendo da comparação. A comparação de cadeias de caracteres pode ser exata, diferenciar maiúsculas e minúsculas ou não diferenciar maiúsculas e minúsculas, ou usar uma subcadeia.

• String message to variable especifica a mensagem de fonte como uma cadeia de caracteres que é enviada a uma variável de destino. Você pode configurar a tarefa para comparar a cadeia de caracteres recebida com uma cadeia de caracteres definida pelo usuário usando uma comparação exata, que não pode diferenciar maiúsculas e minúsculas ou subcadeia. Esse tipo de mensagem só está disponível quando a tarefa estiver recebendo mensagens.

• Variable especifica que a mensagem contém uma ou mais variáveis. Você pode configurar a tarefa para especificar os nomes das variáveis incluídas na mensagem. Ao receber mensagens, você pode configurar a tarefa para especificar o pacote do qual ela pode receber mensagens e a variável que será o destino da mensagem.

enviando mensagens

Ao configurar a tarefa Fila de Mensagens para enviar mensagens, você pode usar um dos algoritmos de criptografia que são atualmente suportados pela tecnologia de Serviço de enfileiramento de mensagens, RC2 e RC4, para criptografar a mensagem. Ambos esses algoritmos de criptografia são agora considerados criptograficamente fracos comparados a algoritmos mais novos que a tecnologia de Serviço de enfileiramento de mensagens ainda não aceita. Então, você deve considerar cuidadosamente suas necessidades de criptografia ao enviar mensagens que usam a tarefa Fila de Mensagens.

recebendo mensagens

Ao receber mensagens, a tarefa Fila de Mensagens pode ser configurada dos seguintes modos:

• Ignorar a mensagem ou remover a mensagem da fila.

• Especificar uma expiração.

• Falhar, se acontecer uma expiração.

• Substituir um arquivo existente, se a mensagem for armazenada em um Data file.

• Gravar o arquivo de mensagem com um nome de arquivo diferente, se a mensagem usar o tipo Data file message .

Mensagens de registro personalizadas disponíveis na tarefa Fila de Mensagens

A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Fila de Mensagens. Para obter mais informações, consulte Log do SSIS (Integration Services).

Configuração da tarefa Fila de Mensagens

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 mais informações sobre como definir essas propriedades programaticamente, consulte a documentação da classe Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MessageQueueTask no Guia do Desenvolvedor.

Related Tasks

Para obter mais informações sobre como definir essas propriedades no Designer do SSIS , consulte Definir as propriedades de uma tarefa ou um contêiner.

Editor da Tarefa Fila de Mensagens (página Geral)

Use a página Geral da caixa de diálogo do Editor da Tarefa Fila de Mensagens para nomear e descrever a tarefa Fila de Mensagens, especificar o formato da mensagem e indicar se a tarefa envia ou recebe mensagens.

Opções

Nome
Forneça um nome exclusivo para a tarefa Fila de Mensagens. Esse nome é usado como rótulo no ícone de tarefa.

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

Use2000Format
Indique se deseja usar o formato 2000 do serviço de enfileiramento de mensagens (também conhecido como MSMQ). O padrão é False.

MSMQConnection
Selecione um gerenciador de conexões de MSMQ existente ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

Tópicos relacionados: Gerenciador de conexões MSMQ, Editor do Gerenciador de conexões MSMQ

Mensagem
Especifique se a tarefa Fila de Mensagens envia ou recebe mensagens. Se você selecionar Enviar mensagem, será listada a página Enviar no painel esquerdo da caixa de diálogo; se você selecionar Receber mensagem, será listada a página Receber. Por padrão, esse valor está definido como Enviar mensagem.

Editor da Tarefa Fila de Mensagens (página Enviar)

Use a página Enviar da caixa de diálogo Editor da Tarefa Fila de Mensagens para configurar uma tarefa de Fila de Mensagens para enviar mensagens de um pacote do Microsoft SQL Server Integration Services.

Opções

UseEncryption
Indique se a mensagem deve ser criptografada. O padrão é False.

EncryptionAlgorithm
Se você escolher usar criptografia, especifique o nome do algoritmo de criptografia a ser utilizado. A tarefa Fila de Mensagens pode usar os algoritmos RC2 e RC4. O padrão é RC2.

MessageType
Selecione o tipo de mensagem. As opções dessa propriedade são listadas na tabela a seguir.

Opções dinâmicas de MessageType

MessageType = Mensagem de arquivo de dados

DataFileMessage
Digite o caminho do arquivo de dados ou clique nas reticências (…) e localize o arquivo.

MessageType = Mensagem de variável

VariableMessage
Digite os nomes de variáveis ou clique nas reticências (...) e, em seguida, selecione as variáveis. As variáveis são separadas por vírgulas.

Tópicos relacionados: Selecionar variáveis

MessageType = Mensagem de cadeia de caracteres

StringMessage
Digite a mensagem de cadeia de caracteres ou clique nas reticências (...) e digite a mensagem na caixa de diálogo Inserir Mensagem de Cadeia de Caracteres.

Editor da Tarefa Fila de Mensagens (página Receber)

Use a página Receber da caixa de diálogo Editor da Tarefa Fila de Mensagens para configurar uma tarefa Fila de Mensagens para receber mensagens do MSMQ (Serviço de Enfileiramento de Mensagens) Microsoft .

Opções

RemoveFromMessageQueue
Indique se a mensagem deve ser removida da fila depois de ser recebida. Por padrão, esse valor é definido como False.

ErrorIfMessageTimeOut
Indique se a tarefa falha quando a mensagem expira, exibindo uma mensagem de erro. O padrão é False.

TimeoutAfter
Se você optar por exibir uma mensagem de erro quando uma tarefa falha, especifique quantos segundos esperar antes de ser exibida a mensagem de tempo limite ultrapassado.

MessageType
Selecione o tipo de mensagem. As opções dessa propriedade são listadas na tabela a seguir.

Opções dinâmicas de MessageType

MessageType = Mensagem de arquivo de dados

SaveFileAs
Digite o caminho do arquivo a ser usado ou clique no botão de reticências (...) e, em seguida, localize o arquivo.

Overwrite
Indique se os dados em um arquivo existente devem ser substituídos quando o conteúdo de uma mensagem de arquivo de dados é salvo. O padrão é False.

Filter
Especifique se deve ser aplicado um filtro à mensagem. As opções dessa propriedade são listadas na tabela a seguir.

Opções dinâmicas do filtro

Filtrar = Sem-filtro

IdentifierReadOnly
Esta opção é somente leitura. Pode ser em branco ou conter o GUID de um pacote quando a propriedade Filtrar tiver sido definida anteriormente.

Filtrar = Do pacote

Identificador
Se você escolher aplicar um filtro, digite o identificador exclusivo do pacote do qual mensagens podem ser recebidas ou clique no botão de reticências (…) e especifique o pacote.

Tópicos relacionados: Selecionar um pacote

MessageType = Mensagem de variável

Filter
Especifique se deve ser aplicado um filtro às mensagens. As opções dessa propriedade são listadas na tabela a seguir.

Variável
Digite o nome da variável ou clique em <Nova variável...> e configure uma variável nova.

Tópicos relacionados: Adicionar variável

Opções dinâmicas do filtro

Filtrar = Sem-filtro

IdentifierReadOnly
Esta opção fica em branco.

Filtrar = Do pacote

Identificador
Se você escolher aplicar um filtro, digite o identificador exclusivo do pacote do qual mensagens podem ser recebidas ou clique no botão de reticências (…) e especifique o pacote.

Tópicos relacionados: Selecionar um pacote

MessageType = Mensagem de cadeia de caracteres

Comparar
Especifique se deve ser aplicado um filtro às mensagens. As opções dessa propriedade são listadas na tabela a seguir.

CompareString
A menos que a opção Comparar esteja definida como Nenhum, forneça a cadeia de caracteres com a qual a mensagem é comparada.

MessageType = Mensagem de cadeia de caracteres para variável

Comparar
Especifique se deve ser aplicado um filtro às mensagens. As opções dessa propriedade são listadas na tabela a seguir.

CompareString
A menos que a opção Comparar esteja definida como Nenhum, forneça a cadeia de caracteres com a qual a mensagem é comparada.

Variável
Digite o nome da variável para manter a mensagem recebida ou clique em <Nova variável...> e configure uma variável nova.

Tópicos relacionados: Adicionar variável

Selecionar variáveis

Use a caixa de diálogo Selecionar Variáveis para especificar as variáveis a serem usadas em uma operação de envio de mensagem na tarefa Fila de Mensagens. A lista das Variáveis Disponíveis inclui variáveis do sistema e aquelas definidas por usuários que estão no escopo da tarefa Fila de Mensagens ou no seu contêiner pai. A tarefa usa as variáveis da lista de Variáveis Selecionadas .

Opções

Variáveis Disponíveis
Selecione uma ou mais variáveis.

Variáveis Selecionadas
Selecione uma ou mais variáveis.

Setas à Direita
Mova as variáveis selecionadas para a lista das Variáveis Selecionadas .

Setas à esquerda
Mova as variáveis selecionadas de volta para a lista das Variáveis Selecionadas .

Nova Variável
Crie uma nova variável.

Tópicos relacionados: Adicionar variável

Confira também

Tarefas do Integration Services
Fluxo de Controle