Amazon S3 conexão s3-connection
Log de alterações de destino changelog
| table 0-row-3 1-row-3 2-row-3 layout-auto | ||
|---|---|---|
| Mês de lançamento | Tipo de atualização | Descrição |
| Janeiro de 2024 | Atualização de funcionalidade e documentação | O conector de destino do Amazon S3 agora oferece suporte a um novo tipo de autenticação de função presumida. Leia mais sobre isso no seção de autenticação. |
| Julho de 2023 | Atualização de funcionalidade e documentação |
Com a versão de julho de 2023 do Experience Platform, a Amazon S3 O destino fornece novas funcionalidades, conforme listado abaixo:
|
Conecte-se ao seu Amazon S3 armazenamento por meio da API ou da interface connect-api-or-ui
- Para se conectar ao seu Amazon S3 local de armazenamento usando a interface do usuário da Platform, leia as seções Conectar ao destino e Ativar públicos para este destino abaixo.
- Para se conectar ao seu Amazon S3 local de armazenamento de dados de forma programática, leia o guia sobre como ativar públicos-alvo para destinos baseados em arquivo usando o tutorial da API do Serviço de fluxo.
Públicos-alvo compatíveis supported-audiences
Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.
Tipo e frequência de exportação export-type-frequency
Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.
Exportar conjuntos de dados export-datasets
Esse destino suporta exportações de conjunto de dados. Para obter informações completas sobre como configurar exportações de conjunto de dados, leia os tutoriais:
Formato de arquivo dos dados exportados file-format
Ao exportar dados de público, a Platform cria um .csv, parquetou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte formatos de arquivo compatíveis com a exportação no tutorial de ativação de público-alvo.
Ao exportar conjuntos de dados, a Platform cria um .parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte verificar exportação bem-sucedida do conjunto de dados no tutorial exportar conjuntos de dados.
Conectar ao destino connect
Para se conectar a esse destino, siga as etapas descritas no tutorial de configuração de destino. No workflow da configuração de destino, preencha os campos listados nas duas seções abaixo.
Autenticar para o destino authenticate
Para autenticar no destino, preencha os campos obrigatórios e selecione Conectar ao destino. O destino do Amazon S3 é compatível com dois métodos de autenticação:
- Autenticação da chave de acesso e da chave secreta
- Autenticação de função presumida
Autenticação da chave de acesso e da chave secreta
Use esse método de autenticação quando quiser inserir sua chave de acesso e chave secreta do Amazon S3 para permitir que o Experience Platform exporte dados para suas propriedades do Amazon S3.
-
Amazon S3chave de acesso e Amazon S3chave secreta: Em Amazon S3, gerar um
access key - secret access keyemparelhe para conceder acesso à Platform ao seu Amazon S3 conta. Saiba mais na Documentação do Amazon Web Services. -
Chave de criptografia: como opção, você pode anexar sua chave pública formatada em RSA para adicionar criptografia aos arquivos exportados. Veja um exemplo de uma chave de criptografia formatada corretamente na imagem abaixo.
Função presumida assumed-role-authentication
Use esse tipo de autenticação se preferir não compartilhar chaves de conta e chaves secretas com a Adobe. Em vez disso, o Experience Platform se conecta ao local do Amazon S3 usando acesso com base em função.
Para fazer isso, é necessário criar no console do AWS um usuário presumido para o Adobe com o permissões necessárias corretas para gravar em seus buckets do Amazon S3. Criar um Entidade confiável no AWS com a conta Adobe 670664943635. Para obter mais informações, consulte Documentação do AWS sobre criação de funções.
- Role: Cole o ARN da função que você criou no AWS para o usuário Adobe. O padrão é semelhante a
arn:aws:iam::800873819705:role/destinations-role-customer. - Chave de criptografia: como opção, você pode anexar sua chave pública formatada em RSA para adicionar criptografia aos arquivos exportados. Veja um exemplo de uma chave de criptografia formatada corretamente na imagem abaixo.
Preencher detalhes do destino destination-details
Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.
-
Nome: digite um nome que ajudará a identificar esse destino.
-
Descrição: digite uma descrição desse destino.
-
Nome do bloco: Insira o nome do Amazon S3 bucket a ser usado por esse destino.
-
Caminho da pasta: insira o caminho para a pasta de destino que hospedará os arquivos exportados.
-
Tipo de arquivo: selecione o formato que o Experience Platform deve usar para os arquivos exportados. Ao selecionar a variável CSV , você também pode configurar as opções de formatação de arquivo.
-
Formato de compactação: selecione o tipo de compactação que o Experience Platform deve usar para os arquivos exportados.
-
Incluir arquivo de manifesto: ative essa opção se desejar que as exportações incluam um arquivo JSON de manifesto que contenha informações sobre o local de exportação, o tamanho da exportação e muito mais. O manifesto é nomeado usando o formato
manifest-<<destinationId>>-<<dataflowRunId>>.json. Exibir um exemplo de arquivo de manifesto. O arquivo de manifesto inclui os seguintes campos:flowRunId: A variável execução do fluxo de dados que gerou o arquivo exportado.scheduledTime: a hora em UTC quando o arquivo foi exportado.exportResults.sinkPath: O caminho no local de armazenamento em que o arquivo exportado está depositado.exportResults.name: o nome do arquivo exportado.size: o tamanho do arquivo exportado, em bytes.
Ativar alertas enable-alerts
Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface do.
Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.
Obrigatório Amazon S3 permissões required-s3-permission
Para conectar e exportar dados para o seu Amazon S3 local de armazenamento, crie um usuário do Identity and Access Management (IAM) para Platform in Amazon S3 e atribuir permissões para as seguintes ações:
s3:DeleteObjects3:GetBucketLocations3:GetObjects3:ListBuckets3:PutObjects3:ListMultipartUploadParts
Ativar públicos-alvo para esse destino activate
- Para ativar os dados, é necessário Exibir destinos, Ativar destinos, Exibir perfis, e Exibir segmentos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.
- Para exportar identidades, você precisará do Exibir gráfico de identidade permissão de controle de acesso.
Consulte Ativar dados do público-alvo para destinos de exportação de perfil em lote para obter instruções sobre como ativar públicos-alvo para esse destino.
Validar exportação de dados bem-sucedida exported-data
Para verificar se os dados foram exportados com êxito, verifique Amazon S3 armazenamento e verifique se os arquivos exportados contêm as populações de perfis esperadas.
INCLUIR NA LISTA DE PERMISSÕES endereço IP ip-address-allow-list
Consulte a INCLUIR NA LISTA DE PERMISSÕES endereço IP consulte este artigo se precisar adicionar IPs de Adobe a um incluo na lista de permissões.