Compartilhar via


Gerenciador de conexões MSMQ

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

Um gerenciador de conexões MSMQ permite que um pacote se conecte a uma fila de mensagens que usa Serviço de enfileiramento de mensagens (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.

Ao adicionar um gerenciador de conexões MSMQ a um pacote, o Integration Services cria um gerenciador de conexões que disponibilizará uma conexão do 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 está definida como MSMQ.

É possível configurar um gerenciador de conexões MSMQ das seguintes maneiras:

  • Fornecendo uma sequência de conexão.

  • Fornecendo o caminho da fila de mensagem à qual se conectar.

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

Tipo de fila Exemplo de caminho
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 gerenciador de conexões MSMQ

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

Para obter mais informações sobre as propriedades que podem ser definidas no Designer do SSIS, confira o Editor do Gerenciador de Conexões MSMQ.

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

Use a caixa de diálogo Gerenciador de Conexões MSMQ para especificar o caminho do Serviço de Enfileiramento de Mensagens (também conhecido como MSMQ).

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

Observação

O gerenciador de conexões MSMQ aceita filas públicas e privadas locais e filas públicas remotas. Não dá suporte a filas privadas remotas. Para obter uma solução alternativa que usa a tarefa Script, consulte Enviando a uma fila de mensagens particular remota com a tarefa 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 Designer do SSIS .

Descrição
Descreva o gerenciador de conexões. Como prática recomendável, descreva o gerenciador de conexões em termos de objetivo, para tornar os pacotes autodocumentados 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 Exemplo de caminho
Público <nome do computador>\<nome da fila>
Privado <nome do computador>\Private$<nome da fila>

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

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

Consulte Também

Tarefa Fila de Mensagens
Conexões do SSIS (Integration Services)