Zum Inhalt springen

Microsoft Azure Service Bus-Connector in Jitterbit Studio

Zusammenfassung

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

Der Microsoft Azure Service Bus-Connector bietet eine Schnittstelle zum Erstellen einer Microsoft Azure Service Bus-Verbindung, die Grundlage für die Generierung von Instanzen von Microsoft Azure Service Bus-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit Microsoft Azure Service Bus über die Verbindung.

Der Microsoft Azure Service Bus-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Microsoft Azure Service Bus-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) verwendet werden sollen.

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

Microsoft Azure Service Bus-Aktivitätstypen

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstattung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Zur Verwendung des Microsoft Azure Service Bus Connectors wird die Verwendung einer Agent-Version 11.26 oder später empfohlen. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren organization policy aussetzen.

Der Service Bus-Namespace, der in der Verbindung verwendet wird, muss die Rolle Azure Service Bus Data Owner zugewiesen bekommen.

Bei Verwendung der Agent-Version 10.87 / 11.25 oder früher werden in kurzer Zeit übermäßig viele INFO-Protokolle generiert, was zu Speicherplatzproblemen aufgrund der Größe der Datei catalina.out führt. Dieses bekannte Problem ist für Agent-Version 11.26 und später behoben.

Ein Upgrade auf Agent-Version 11.26 oder später wird empfohlen. Alternativ kann dieses Problem in Agent-Version 10.87 / 11.25 oder früher durch Hinzufügen der folgenden Einstellungen zur Datei logback.xml unter C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) oder /opt/jitterbit/tomcat/shared/lib (Linux) behoben werden:

<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 Aktivitäten Warteschlange nutzen und Thema nutzen müssen bestimmte Voraussetzungen erfüllt sein.

Fehlerbehebung

Falls Probleme mit dem Microsoft Azure Service Bus-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Falls private Agents verwendet werden, stellen Sie sicher, dass Sie Agent-Version 11.26 oder später verwenden, und überprüfen Sie die Agent-Protokolle für weitere Informationen.

  5. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung für Operationen.