Amazon SQS-Connector für Jitterbit Studio

Zusammenfassung

Der Amazon SQS-Connector stellt den Zugriff auf Amazon SQS her.

Der Amazon SQS-Connector bietet eine Schnittstelle zum Erstellen einer Amazon SQS-Verbindung, die als Grundlage für die Generierung von Instanzen von Amazon SQS-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Amazon SQS.

Der Amazon SQS-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 Amazon SQS-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 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 ist als Ziel in einem Vorgang gedacht.
Nachricht empfangen: Lauscht auf und ruft Nachrichten aus einer Amazon SQS-Warteschlange ab und ist als Quelle in einem Vorgang gedacht.
Nachrichten abrufen: Ruft alle verfügbaren Amazon SQS-Nachrichten in einer bestimmten Warteschlange ab und ist als Quelle in einem Vorgang gedacht.
Warteschlange erstellen: Erstellt Standardwarteschlangen oder FIFO-Warteschlangen in Amazon SQS und ist als Ziel in einem Vorgang gedacht.
Nachrichten löschen: Löscht Nachrichten aus einer Amazon SQS-Warteschlange und ist als Ziel in einer Operation vorgesehen.
Warteschlangen auflisten: Listet Amazon SQS-Warteschlangen auf und ist als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Connector ist ein auf dem Connector SDK-basiertes 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 Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Amazon SQS-Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Um alle Aktivitäten in diesem Connector erfolgreich nutzen zu können, müssen Sie über die folgenden AWS IAM-Kontoberechtigungen verfügen:

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

Berechtigungen für mehrere Konten gelten nicht für diese Aktion. Weitere Informationen finden Sie in den Grundlegenden Beispielen für Amazon SQS-Richtlinien im Amazon SQS Entwicklerhandbuch.

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

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

Fehlersuche

Wenn Sie Probleme mit dem Amazon SQS-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

Klicken Sie auf die Test-Schaltfläche in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten 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 den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.
Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokoll für diesen Connector aktivieren, indem Sie diese spezifischen Konfigurationseinträge für den Logger-Namen und das Level hinzufügen. 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 Protokoll für Connectoren finden Sie unter Ausführliches Protokoll für Connectoren mit Jitterbit-Privatagenten.
Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.
Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlersuche bei Operationen.