Amazon S3-Connector in Jitterbit Studio

Zusammenfassung

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

Der Amazon S3-Connector bietet eine Schnittstelle zur Erstellung einer Amazon S3-Verbindung, die die Grundlage für die Generierung von Instanzen von Amazon S3-Aktivitäten bildet. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Amazon S3.

Der Amazon S3-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Wichtig

Wenn Sie eine Amazon S3 Vectors-Instanz als Vektorspeicher für eine Amazon Bedrock-Wissensdatenbank verwenden, nutzen Sie eine Amazon Bedrock Prompt-Aktivität, um mit ihr zu interagieren. Der Amazon S3-Connector ist nicht erforderlich.

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Amazon S3-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) verwendet werden sollen.

Zusammen werden eine spezifische Amazon S3-Verbindung und ihre Aktivitäten als Amazon S3-Endpunkt bezeichnet:

Amazon S3-Aktivitätstypen

Objekt verschieben: Verschiebt ein Objekt von einem Amazon S3-Bucket in einen anderen und ist als Ziel in einem Vorgang vorgesehen.
Objekt löschen: Löscht ein Objekt aus einem Amazon S3-Bucket und ist als Ziel in einem Vorgang vorgesehen.
Objekt hochladen: Platziert ein Objekt in einem Amazon S3-Bucket und ist als Ziel in einem Vorgang vorgesehen.
Get Object: Ruft ein Objekt aus einem Amazon S3-Bucket ab und ist als Quelle in einer Operation vorgesehen.
List Objects: Gibt einige oder alle (bis zu 100.000) Objekte in einem Amazon S3-Bucket zurück und ist als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, 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 S3-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 die Aktivitäten des Amazon S3-Connectors zu nutzen, muss die Amazon S3-Instanz bestimmte Berechtigungen festgelegt haben. Alle Aktivitäten des Connectors erfordern die Berechtigung s3:ListAllMyBuckets. Darüber hinaus erfordern einzelne Aktivitäten zusätzliche spezifische Berechtigungen. Die folgende Tabelle fasst die erforderlichen Berechtigungen zusammen:

Benötigte Berechtigung	Funktionalität
`s3:ListAllMyBuckets`	Testen der [Verbindung] und Abrufen von Aktivitätsmetadaten während der Aktivitätskonfiguration
`s3:PutObject` und `s3:GetBucketLocation`	Ausführung der Put Object activity
`s3:GetObject`, `s3:ListBucket` und `s3:GetObjectTagging` (optional)	Ausführung der Get Object activity Hinweis Die Berechtigung `s3:GetObjectTagging` ist nur erforderlich, wenn die optionale Einstellung Tagging-Metadaten in der Antwort einbeziehen für die Get Object-Aktivität aktiviert ist.
`s3:GetObject`, `s3:ListBucket` und `s3:GetObjectTagging`	Ausführung der List Objects activity
`s3:DeleteObject`	Ausführung der Delete Object activity
`s3:GetObject` und `s3:PutObject`	Ausführung der Move Object activity

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

Fehlerbehebung

Wenn Probleme mit dem Amazon S3-Connector auftreten, 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 Agenten heruntergeladen wird (es sei denn, die Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie wird verwendet).
Ü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 Vorgang (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 den Connector für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:
```
<logger name="org.jitterbit.connector.amazon" level="DEBUG"/>
```

Für weitere Informationen zum ausführlichen Protokollieren von Verbindern siehe Ausführliches Protokollieren für Verbinder mit Jitterbit-Privatagenten.

Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle für weitere Informationen überprüfen.
Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.