Conector do Microsoft Azure Service Bus para o Jitterbit Studio

Resumo

O conector do Microsoft Azure Service Bus estabelece acesso a um namespace do Microsoft Azure Service Bus.

O conector do Microsoft Azure Service Bus fornece uma interface para criar uma conexão do Microsoft Azure Service Bus, a base utilizada para gerar instâncias de atividades do Microsoft Azure Service Bus. Essas atividades, uma vez configuradas, interagem com o Microsoft Azure Service Bus por meio da conexão.

O conector do Microsoft Azure Service Bus é acessado na aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão do Microsoft Azure Service Bus. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão específica do Microsoft Azure Service Bus e suas atividades são referidos como um endpoint do Microsoft Azure Service Bus:

• Obter Mensagem da Fila: Recupera todas as mensagens em uma fila do Microsoft Azure Service Bus e é destinada a ser usada como uma fonte em uma operação.

• Desbloquear Mensagem do Tópico: Desbloqueia mensagens em um tópico do Microsoft Azure Service Bus e é destinada a ser usada como um alvo em uma operação.

• Excluir Mensagem da Fila: Exclui mensagens de uma fila do Microsoft Azure Service Bus e é destinada a ser usada como um alvo em uma operação.

• Consumir Tópico: Consome mensagens de um tópico do Microsoft Azure Service Bus e é destinada a ser usada como uma fonte em uma operação.

• Renovar Bloqueio de Mensagem do Tópico: Renova bloqueios de mensagens em um tópico do Microsoft Azure Service Bus e é destinada a ser usada como um alvo em uma operação.

• Excluir Mensagem do Tópico: Exclui mensagens de um tópico do Microsoft Azure Service Bus e é destinada a ser usada como um alvo em uma operação.

• Enviar Mensagem: Envia mensagens para uma fila ou tópico do Microsoft Azure Service Bus e é destinada a ser usada como um alvo em uma operação.

• Consumir Fila: Consome mensagens de uma fila do Microsoft Azure Service Bus e é destinada a ser usada como uma fonte em uma operação.

• Renovar Bloqueio de Mensagem da Fila: Renova bloqueios de mensagens em uma fila do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

• Obter Mensagem do Tópico: Recupera mensagens de um tópico do Microsoft Azure Service Bus e é destinado a ser usado como uma fonte em uma operação.

• Desbloquear Mensagem da Fila: Desbloqueia mensagens de uma fila do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

Pré-requisitos e versões de API suportadas

Para usar o conector do Microsoft Azure Service Bus, recomenda-se o uso de uma versão do agente 11.26 ou posterior. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

O namespace do Service Bus sendo usado na conexão deve ter o papel de Proprietário de Dados do Azure Service Bus atribuído.

Quando se utiliza a versão 10.87 / 11.25 do agente ou anterior, um número excessivo de logs INFO é gerado em um curto período de tempo, levando a problemas de espaço em disco devido ao tamanho do arquivo catalina.out. Este problema conhecido foi resolvido para a versão 11.26 do agente e posteriores.

Recomenda-se uma atualização para a versão 11.26 do agente ou posterior. Como alternativa, este problema pode ser resolvido na versão 10.87 / 11.25 do agente ou anterior, adicionando as seguintes configurações ao arquivo logback.xml localizado em C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) ou /opt/jitterbit/tomcat/shared/lib (Linux):

<logger name="com.azure.core.amqp" level="ERROR"/>
<logger name="com.azure.messaging.servicebus" level="ERROR"/>
<logger name="com.azure.core.implementation" level="ERROR"/>

O conector Microsoft Azure Service Bus utiliza o Microsoft Azure Service Bus Client for Java v3.6.7. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

Antes de usar as atividades de consumir fila e atividades de consumir tópico, certos pré-requisitos devem ser atendidos.

Solução de Problemas

Se você encontrar problemas com o conector Microsoft Azure Service Bus, recomenda-se seguir estas etapas de solução de problemas:

1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desabilitar Atualização Automática do Conector).

2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

3. Ative o registro de depuração de operações (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

4. Se estiver usando agentes privados, certifique-se de que está utilizando a versão do agente 11.26 ou posterior e verifique os logs do agente para mais informações.

5. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operações.