Partilhar via


Gerenciador de conexões MSMQ

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

Um gestor de ligações MSMQ permite que um pacote se conecte a uma fila de mensagens que utiliza o serviço de Mensagens em Fila (também conhecido como MSMQ). A tarefa Fila de Mensagens que o Microsoft SQL Server Integration Services inclui usa um gerenciador de conexões MSMQ.

Quando você adiciona um gerenciador de conexões MSMQ a um pacote, o Integration Services cria um gerenciador de conexões que será resolvido para uma conexão MSMQ em tempo de execução, define as propriedades do gerenciador de conexões e adiciona o gerenciador de conexões à coleção Connections no pacote. A propriedade ConnectionManagerType do gerenciador de conexões é definida como MSMQ.

Você pode configurar um gerenciador de conexões MSMQ das seguintes maneiras:

  • Forneça uma cadeia de conexão.

  • Forneça o caminho da fila de mensagens à qual se conectar.

O formato do caminho depende do tipo de fila, conforme mostrado na tabela a seguir.

Tipo de fila Caminho de exemplo
Público <nome do computador>\<nome da fila>
Privado <nome_do_computador>\Private$\<nome_da_fila>

Você pode usar um ponto (.) para representar o computador local.

Configuração do MSMQ Connection Manager

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

Para obter informações sobre como configurar um gerenciador de conexões programaticamente, consulte ConnectionManager e Adicionando conexões programaticamente.

Editor do Gerenciador de Conexões MSMQ

Utilize a janela de diálogo Gestor de Conexões MSMQ para especificar o caminho para uma fila de mensagens MSMQ (também conhecido como serviço de enfileiramento de mensagens).

Para saber mais sobre o gerenciador de conexões MSMQ, consulte Gerenciador de conexões MSMQ.

Observação

O gerenciador de conexões MSMQ suporta filas públicas e privadas locais e filas públicas remotas. Não suporta filas privadas remotas. Para obter uma solução alternativa que utilize a Tarefa de Script, consulte Envio para uma Fila de Mensagens Privada Remota com a Tarefa de Script.

Opções

Nome
Forneça um nome exclusivo para o gerenciador de conexões MSMQ no fluxo de trabalho. O nome fornecido será exibido no SSIS Designer.

Descrição
Descreva o gerenciador de conexões. Como prática recomendada, descreva o gerenciador de conexões em termos de sua finalidade, para tornar os pacotes autodocumentáveis e mais fáceis de manter.

Caminho
Digite o caminho completo da fila de mensagens. O formato do caminho depende do tipo de fila.

Tipo de fila Caminho de exemplo
Público <nome do computador>\<nome da fila>
Privado <nome_do_computador>\Private$\<nome_da_fila>

Você pode usar "." para representar o computador local.

Teste
Depois de configurar o gerenciador de conexões MSMQ, confirme se a conexão é viável clicando em Testar.

Ver também

Tarefa da fila de mensagens
Conexões do Integration Services (SSIS)