Zum Inhalt springen

Amazon S3-Connector in Jitterbit Studio

Zusammenfassung

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

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

Der Amazon S3-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectors) der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Wichtig

Bei Verwendung einer Amazon S3 Vectors-Instanz als Vektorspeicher für eine Amazon Bedrock-Wissensdatenbank wird eine Amazon Bedrock-Prompt-Aktivität zur Interaktion damit verwendet. Der Amazon S3-Connector ist nicht erforderlich.

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Amazon S3-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 S3-Verbindung und ihre Aktivitäten als Amazon S3-Endpunkt bezeichnet:

Amazon S3-Aktivitätstypen

  • Move Object: Verschiebt ein Objekt von einem Amazon S3-Bucket zu einem anderen und ist als Ziel in einem Vorgang vorgesehen.

  • Delete Object: Löscht ein Objekt aus einem Amazon S3-Bucket und ist als Ziel in einem Vorgang vorgesehen.

  • Put Object: 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 einem Vorgang vorgesehen.

  • List Objects: Gibt einige oder alle (bis zu 100.000) Objekte in einem Amazon S3-Bucket zurück und ist als Ziel in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte werden in die Endpunkt-Nutzungsberichte einbezogen und werden auf Ihre 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 Disable Auto Connector Update (Automatische Connector-Aktualisierung deaktivieren) ausgesetzt werden.

Um die Aktivitäten des Amazon S3-Connectors zu verwenden, muss die Amazon S3-Instanz über bestimmte Berechtigungen verfügen. 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:

Erforderliche 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-Aktivität]
s3:GetObject, s3:ListBucket und s3:GetObjectTagging (optional) Ausführung der [Get Object-Aktivität]

Hinweis

Die Berechtigung s3:GetObjectTagging ist nur erforderlich, wenn die optionale Einstellung Include tagging metadata in Response (Tagging-Metadaten in Antwort einschließen) für die Aktivität Get Object aktiviert ist.
s3:GetObject, s3:ListBucket und s3:GetObjectTagging Ausführung der [List Objects-Aktivität]
s3:DeleteObject Ausführung der [Delete Object-Aktivität]
s3:GetObject und s3:PutObject Ausführung der [Move Object-Aktivität]

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

Fehlerbehebung

Falls Probleme mit dem Amazon S3-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. Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die Datei logback.xml Ihres privaten Agents einfügen:

    <logger name="org.jitterbit.connector.amazon" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

  5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.