Ir para o conteúdo

Conector Amazon S3 no Jitterbit Studio

Resumo

O conector Amazon S3 estabelece acesso ao Amazon S3.

O conector Amazon S3 fornece uma interface para criar uma conexão Amazon S3, a base usada para gerar instâncias de atividades Amazon S3. Essas atividades, uma vez configuradas, interagem com o Amazon S3 através da conexão.

O conector Amazon S3 é acessado pela aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Importante

Se estiver usando uma instância do Amazon S3 Vectors como armazenamento de vetores para uma base de conhecimento do Amazon Bedrock, use uma atividade Prompt do Amazon Bedrock para interagir com ela. O conector Amazon S3 não é necessário.

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Amazon S3. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntos, uma conexão Amazon S3 específica e suas atividades são chamados de endpoint Amazon S3:

Amazon S3 activity types

  • Move Object: Move um objeto de um bucket Amazon S3 para outro e é destinado a ser usado como destino em uma operação.

  • Delete Object: Exclui um objeto de um bucket Amazon S3 e é destinado a ser usado como destino em uma operação.

  • Put Object: Coloca um objeto em um bucket Amazon S3 e é destinado a ser usado como destino em uma operação.

  • Get Object: Recupera um objeto de um bucket Amazon S3 e é destinado a ser usado como fonte em uma operação.

  • List Objects: Retorna alguns ou todos (até 100.000) dos objetos em um bucket Amazon S3 e é destinado a ser usado como destino em uma operação.

Os endpoints criados com este conector são incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, é possível suspender essas atualizações com a política de organização Disable Auto Connector Update (Desabilitar atualização automática de conector).

Para usar as atividades do conector Amazon S3, a instância Amazon S3 deve ter certas permissões definidas. Todas as atividades do conector exigem a permissão s3:ListAllMyBuckets. Além disso, atividades individuais exigem permissões específicas adicionais. A tabela a seguir resume as permissões necessárias:

Permissão necessária Funcionalidade
s3:ListAllMyBuckets Teste da [conexão] e recuperação de metadados de atividade durante a configuração de atividade
s3:PutObject e s3:GetBucketLocation Execução da [atividade Put Object]
s3:GetObject, s3:ListBucket e s3:GetObjectTagging (opcional) Execução da [atividade Get Object]

Nota

A permissão s3:GetObjectTagging é necessária apenas quando a configuração opcional Include tagging metadata in Response (Incluir metadados de marcação na resposta) está habilitada para a atividade Get Object.
s3:GetObject, s3:ListBucket e s3:GetObjectTagging Execução da [atividade List Objects]
s3:DeleteObject Execução da [atividade Delete Object]
s3:GetObject e s3:PutObject Execução da [atividade Move Object]

O conector Amazon S3 usa a API do Amazon Simple Storage Service. Consulte a documentação de ações da API Amazon S3 para obter informações sobre os nós de esquema e campos.

Solução de problemas

Se você enfrentar problemas com o conector Amazon S3, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política de organização Desabilitar Atualização Automática de Conector).

  2. Verifique os logs de operação para obter informações registradas durante a execução da operação.

  3. Ative o log de depuração de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

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

    Para obter mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

  5. Se estiver usando agentes privados, você pode verificar os logs do agente para obter mais informações.

  6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.