Ir para o conteúdo

Atividade Listar Objetos do Amazon S3

Introdução

Uma atividade Listar Objetos do Amazon S3, utilizando sua conexão com o Amazon S3, retorna alguns ou todos (até 100.000) os objetos em um bucket do Amazon S3 e é destinada a ser usada como um destino para consumir dados em uma operação.

Pré-requisitos

A atividade Listar Objetos requer as seguintes permissões do Amazon S3:

Permissão necessária Funcionalidade
s3:ListAllMyBuckets Testar a conexão e recuperar metadados da atividade durante a configuração da atividade
s3:GetObject, s3:GetObjectTagging e s3:ListBucket Execução da atividade Listar Objetos

Criar uma atividade Listar Objetos do Amazon S3

Uma instância de uma atividade Listar Objetos do Amazon S3 é criada a partir de uma conexão com o Amazon S3 usando seu tipo de atividade Listar Objetos.

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, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade Listar Objetos do Amazon S3 existente pode ser editada a partir destes locais:

Configurar uma atividade de Listar Objetos do Amazon S3

Siga estas etapas para configurar uma atividade de Listar Objetos do Amazon S3:

Etapa 1: Insira um nome e selecione um bucket

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

A interface utilizada nesta etapa da configuração de uma atividade de Listar Objetos do Amazon S3 depende das Opções de Bucket selecionadas:

  • Usar listas: Esta opção irá preencher uma lista de buckets existentes para escolher.

  • Usar entradas de texto: Para esta opção, você irá inserir manualmente o nome do bucket do Amazon S3.

Usar listas

Se Usar Listas for selecionado para Opções de Bucket, a interface descrita abaixo é apresentada.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade de Listar Objetos do Amazon S3 e não deve conter barras (/) ou dois pontos (:).

  • Selecionar um Bucket: A partir da lista preenchida, selecione o bucket que contém os objetos.

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

    • Prefixo do Objeto: Insira um prefixo para limitar a resposta a chaves que começam com o prefixo especificado.

      • Excluir Correspondência Exata do Prefixo dos Resultados: Selecione para excluir correspondências exatas para o prefixo especificado em Prefixo do Objeto.

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

    • Máx Chaves: Insira 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: Insira uma chave para retornar uma resposta que comece 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.

Usar entradas de texto

Se Usar Entradas de Texto estiver selecionado para Opções do Bucket, a interface descrita abaixo será apresentada.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade Listar Objetos do Amazon S3 e não deve conter barras (/) ou dois pontos (:).

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

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

    • Prefixo do Objeto: Insira um prefixo para limitar a resposta a chaves que começam com o prefixo especificado.

      • Excluir Correspondência Exata do Prefixo dos Resultados: Selecione para excluir correspondências exatas para o prefixo especificado em Prefixo do Objeto.

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

    • Máx Chaves: Insira 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: Insira uma chave para retornar uma resposta que comece 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 & Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta 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 qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Quaisquer 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 transformação.

    O conector Amazon S3 utiliza 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 nos seguintes 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 multipart 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 atualizar ou na palavra Atualizar para regenerar esquemas do endpoint Amazon S3. Esta ação também regenera um esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para esta 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 qualquer etapa. Uma mensagem pede que você confirme que deseja descartar as alterações.

Próximas etapas

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

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja o menu de ações da atividade em Conceitos básicos do conector.

Atividades Listar Objetos do Amazon S3 podem ser usadas como um alvo com esses padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, 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.