Amazon SQS-Connector in Jitterbit Studio

Zusammenfassung

Der Amazon SQS-Connector stellt Zugriff auf Amazon SQS bereit.

Der Amazon SQS-Connector bietet eine Schnittstelle zum Erstellen einer Amazon SQS-Verbindung, die Grundlage für die Generierung von Amazon SQS-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration mit Amazon SQS über die Verbindung.

Der Amazon SQS-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 Amazon SQS-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte Amazon SQS-Verbindung und ihre Aktivitäten als Amazon SQS-Endpunkt bezeichnet:

Amazon SQS-Aktivitätstypen

Nachrichten senden: Sendet Nachrichten aus einer Amazon SQS-Warteschlange und soll als Ziel in einem Vorgang verwendet werden.
Nachricht empfangen: Überwacht und ruft Nachrichten aus einer Amazon SQS-Warteschlange ab und soll als Quelle in einem Vorgang verwendet werden.
Nachrichten abrufen: Ruft alle in einer bestimmten Warteschlange verfügbaren Amazon SQS-Nachrichten ab und soll als Quelle in einem Vorgang verwendet werden.
Warteschlange erstellen: Erstellt Standard-Warteschlangen oder FIFO-Warteschlangen in Amazon SQS und soll als Ziel in einem Vorgang verwendet werden.
Nachrichten löschen: Löscht Nachrichten aus einer Amazon SQS-Warteschlange und soll als Ziel in einem Vorgang verwendet werden.
Warteschlangen auflisten: Listet Amazon SQS-Warteschlangen auf und soll als Ziel in einem Vorgang verwendet werden.

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

Voraussetzungen und unterstützte API-Versionen

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

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren ausgesetzt werden.

Um alle Aktivitäten in diesem Connector erfolgreich zu nutzen, benötigen Sie die folgenden AWS IAM-Kontoberechtigungen:

sqs:CreateQueue
sqs:DeleteMessage
sqs:GetQueueUrl
sqs:ListQueues
sqs:ReceiveMessage
sqs:SendMessage

Kontoübergreifende Berechtigungen gelten nicht für diese Aktion. Weitere Informationen finden Sie unter Grundlegende Beispiele für Amazon SQS-Richtlinien im Amazon SQS-Entwicklerhandbuch.

Der Amazon SQS-Connector verwendet die Amazon SQS-API. Informationen zu den Schemaknoten und Feldern finden Sie in der Dokumentation zu Amazon SQS-API-Aktionen.

Vor der Verwendung der Aktivität „Nachricht empfangen" müssen bestimmte Voraussetzungen erfüllt sein.

Fehlerbehebung

Falls Probleme mit dem Amazon SQS-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

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).
Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.
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.
Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector mit diesen spezifischen Konfigurationseinträgen des Logger-Namens und der Ebene aktivieren. Fügen Sie beide Zeilen hinzu:
```
<logger name="org.jitterbit.connector.verbose.logging.amazonsqs" level="DEBUG"/>
<logger name="org.jitterbit.connector.amazonsqs" level="DEBUG"/>
```
Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.
Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.
Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.