Microsoft Azure Service Bus-Connector für Jitterbit Studio

Zusammenfassung

Der Microsoft Azure Service Bus-Connector stellt den Zugriff auf einen Microsoft Azure Service Bus Namensraum her.

Der Microsoft Azure Service Bus-Connector bietet eine Schnittstelle zur Erstellung einer Microsoft Azure Service Bus-Verbindung, die als Grundlage für die Generierung von Instanzen von Microsoft Azure Service Bus-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit dem Microsoft Azure Service Bus.

Der Microsoft Azure Service Bus-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Microsoft Azure Service Bus-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

Zusammen werden eine spezifische Microsoft Azure Service Bus-Verbindung und ihre Aktivitäten als Microsoft Azure Service Bus-Endpunkt bezeichnet:

Microsoft Azure Service Bus-Aktivitätstypen

Nachricht aus der Warteschlange abrufen: Ruft alle Nachrichten in einer Microsoft Azure Service Bus Warteschlange ab und ist als Quelle in einem Vorgang gedacht.
Nachricht im Thema entsperren: Entsperrt Nachrichten in einem Microsoft Azure Service Bus Thema und ist als Ziel in einem Vorgang gedacht.
Nachricht aus der Warteschlange löschen: Löscht Nachrichten aus einer Microsoft Azure Service Bus Warteschlange und ist als Ziel in einer Operation vorgesehen.
Thema konsumieren: Konsumiert Nachrichten aus einem Microsoft Azure Service Bus Thema und ist als Quelle in einer Operation vorgesehen.
Nachrichtenschloss für Thema erneuern: Erneuert Nachrichtenschlösser in einem Microsoft Azure Service Bus Thema und ist als Ziel in einer Operation vorgesehen.
Nachricht aus dem Thema löschen: Löscht Nachrichten aus einem Microsoft Azure Service Bus Thema und ist als Ziel in einer Operation vorgesehen.
Nachricht senden: Sendet Nachrichten an eine Microsoft Azure Service Bus Warteschlange oder ein Thema und ist als Ziel in einer Operation vorgesehen.
Warteschlange konsumieren: Konsumiert Nachrichten aus einer Microsoft Azure Service Bus Warteschlange und ist als Quelle in einer Operation vorgesehen.
Renew Queue Message Lock: Erneuert Nachrichtenlocks in einer Microsoft Azure Service Bus Warteschlange und ist als Ziel in einer Operation vorgesehen.
Get Topic Message: Ruft Nachrichten aus einem Microsoft Azure Service Bus Thema ab und ist als Quelle in einer Operation vorgesehen.
Unlock Queue Message: Entsperrt Nachrichten aus einer Microsoft Azure Service Bus Warteschlange und ist als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Connector ist ein auf dem Connector SDK-basierten Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in der Endpunktnutzungsberichterstattung enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Um den Microsoft Azure Service Bus-Connector zu verwenden, wird die Verwendung einer Agent-Version 11.26 oder höher empfohlen. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Der verwendete Service Bus-Namespace in der Verbindung muss die Rolle Azure Service Bus Data Owner zugewiesen sein.

Wenn Sie die Agent-Version 10.87 / 11.25 oder früher verwenden, werden in kurzer Zeit eine übermäßige Anzahl von INFO-Protokollen generiert, was zu Problemen mit dem Speicherplatz aufgrund der Größe der Datei catalina.out führt. Dieses bekannte Problem wurde für die Agent-Version 11.26 und höher behoben.

Ein Upgrade auf die Agent-Version 11.26 oder höher wird empfohlen. Alternativ kann dieses Problem in der Agent-Version 10.87 / 11.25 oder früher behoben werden, indem die folgenden Einstellungen in die Datei logback.xml eingefügt werden, die sich in C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) oder /opt/jitterbit/tomcat/shared/lib (Linux) befindet:

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

Der Microsoft Azure Service Bus-Connector verwendet den Microsoft Azure Service Bus Client für Java v3.6.7. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

Vor der Verwendung der Consume queue und Consume topic activities müssen bestimmte Voraussetzungen erfüllt sein.

Fehlerbehebung

Wenn Sie Probleme mit dem Microsoft Azure Service Bus-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

Klicken Sie auf die Schaltfläche Test in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Auto Connector Update deaktivieren).
Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
Aktivieren Sie das Debug-Protokoll für Operationen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.
Wenn Sie private Agenten verwenden, stellen Sie sicher, dass Sie die Agenten-Version 11.26 oder höher verwenden, und überprüfen Sie die Agentenprotokolle für weitere Informationen.
Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.