Conector Microsoft Azure Service Bus no Jitterbit Studio

Resumo

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

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

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

Visão geral do conector

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

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

• Get Queue Message: Recupera todas as mensagens em uma fila do Microsoft Azure Service Bus e é destinada a ser usada como uma fonte em uma operação.

• Unlock Topic Message: Desbloqueia mensagens em um tópico do Microsoft Azure Service Bus e é destinada a ser usada como um destino em uma operação.

• Delete Queue Message: Exclui mensagens de uma fila do Microsoft Azure Service Bus e é destinada a ser usada como um destino em uma operação.

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

• Renew Topic Message Lock: Renova bloqueios de mensagens em um tópico do Microsoft Azure Service Bus e é destinada a ser usada como um destino em uma operação.

• Delete Topic Message: Exclui mensagens de um tópico do Microsoft Azure Service Bus e é destinada a ser usada como um destino em uma operação.

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

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

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

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

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

Os endpoints criados com este conector são incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Para usar o conector 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. Em agentes privados, é possível suspender essas atualizações com a política de organização Desabilitar Atualização Automática de Conector.

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

Ao usar a versão do agente 10.87 / 11.25 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 como resultado do tamanho do arquivo catalina.out. Este problema conhecido é resolvido para a versão do agente 11.26 e posterior.

Recomenda-se uma atualização para a versão do agente 11.26 ou posterior. Como alternativa, este problema pode ser resolvido na versão do agente 10.87 / 11.25 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 usa o Microsoft Azure Service Bus Client para Java v3.6.7. Consulte a documentação da API para obter informações sobre os nós de esquema e campos.

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

Solução de problemas

Se você enfrentar problemas com o conector do 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 para garantir que a versão mais recente do conector seja baixada no 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 log de depuração de operação (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á usando a versão do agente 11.26 ou posterior e verifique os logs do agente para obter mais informações.

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