Ir para o conteúdo

Atividade Amazon S3 List Objects no Jitterbit Studio

Introdução

Uma atividade Amazon S3 List Objects, usando sua conexão Amazon S3, retorna alguns ou todos (até 100.000) dos objetos em um bucket Amazon S3 e é destinada a ser usada como destino para consumir dados em uma operação.

Pré-requisitos

A atividade List Objects requer as seguintes permissões Amazon S3:

Permissão necessária Funcionalidade
s3:ListAllMyBuckets Teste da conexão e recuperação de metadados da atividade durante a configuração
s3:GetObject, s3:GetObjectTagging, e s3:ListBucket Execução da atividade List Objects

Criar uma atividade Amazon S3 List Objects

Uma instância de uma atividade Amazon S3 List Objects é criada a partir de uma conexão Amazon S3 usando seu tipo de atividade List Objects.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade Amazon S3 List Objects existente pode ser editada a partir destes locais:

Configurar uma atividade Amazon S3 List Objects

Siga estas etapas para configurar uma atividade Amazon S3 List Objects:

Etapa 1: Insira um nome e selecione um bucket

Nesta etapa, forneça um nome para a atividade e selecione um bucket a ser usado.

A interface usada nesta etapa da configuração de uma atividade Amazon S3 List Objects depende das Opções de Bucket selecionadas:

Selecionar Bucket da Lista

Se Selecionar Bucket da Lista for selecionado para Opções de Bucket, a interface descrita abaixo será apresentada.

  • Menu Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

  • Editar endpoint: Aparece ao passar o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado.

  • Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Amazon S3 List Objects e não pode conter barras (/) ou dois-pontos (:).

  • Selecionar um bucket: Na lista preenchida, selecione o bucket que contém os objetos.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais.

    • Prefixo do objeto: Digite um prefixo para limitar a resposta às chaves que começam com o prefixo especificado.

      • Excluir correspondência exata do prefixo dos resultados: Selecione para excluir correspondências exatas do prefixo especificado em Prefixo do objeto.

    • Delimitador: Digite um caractere para usar como delimitador (máximo de 1 caractere).

    • Máximo de chaves: Digite o número máximo de chaves a serem retornadas na resposta. Por padrão, a atividade retorna até 1.000 nomes de chaves. O máximo é 100.000 chaves.

    • Iniciar após: Digite uma chave para retornar uma resposta que começa após a chave especificada. O valor máximo é 1.024 caracteres.

    • Região AWS (substitui a região do bucket): Selecione uma região do Amazon S3.

Fornecer bucket S3 manualmente

Se Fornecer bucket S3 manualmente for selecionado para Opções de bucket, a interface descrita abaixo será apresentada.

  • Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Amazon S3 List Objects e não pode conter barras (/) ou dois-pontos (:).

  • Nome do bucket: Digite o nome do bucket Amazon S3 que contém os objetos.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais.

    • Prefixo do objeto: Digite um prefixo para limitar a resposta às chaves que começam com o prefixo especificado.

      • Excluir correspondência exata do prefixo dos resultados: Selecione para excluir correspondências exatas do prefixo especificado em Prefixo do objeto.

    • Delimitador: Digite um caractere para usar como delimitador (máximo de 1 caractere).

    • Máximo de chaves: Digite o número máximo de chaves a serem retornadas na resposta. Por padrão, a atividade retorna 1.000 chaves. O máximo é 100.000 chaves.

    • Iniciar após: Digite uma chave para retornar uma resposta que começa após a chave especificada. O valor máximo é 1.024 caracteres.

    • Região AWS (substitui a região do bucket): Selecione uma região do Amazon S3.

  • Salvar e sair: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Todos os esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Esquemas de dados: Os esquemas de solicitação e resposta para esta atividade são exibidos. Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de dados.

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

    O esquema de dados de resposta consiste nestes nós e campos:

    Campo do esquema de resposta Descrição
    keyCount O número de chaves retornadas
    List A lista de chaves, resultados retornados em ordem binária UTF-8
    key String com a chave do upload de múltiplas partes iniciado
    size Tamanho
    ETag A tag de entidade (ETag) que identifica o novo objeto
    lastModified Valor de data e hora do cabeçalho Last-Modified, indicando a data e hora em que o Amazon S3 registrou pela última vez uma modificação no objeto associado
    error Contêiner para todos os elementos de erro
    errorCode Uma string que identifica exclusivamente uma condição de erro
    message Uma descrição genérica da condição de erro

  • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas do endpoint do Amazon S3. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade List Objects do Amazon S3, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos de trabalho diferentes.

As ações de menu de uma atividade são acessíveis no painel do projeto e na tela de design. Para obter detalhes, consulte Menu de ações da atividade em Noções básicas do conector.

As atividades List Objects do Amazon S3 podem ser usadas como destino com estes padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.