Você está aqui:
Conexão de saída do Amazon S3
Crie uma conexão remota usando o conector de saída do Amazon S3 para gravar dados de .csv do CRM Analytics em um bucket do Amazon S3 ao usar o Preparador de dados.
Como funcionam os conectores de saída do CRM Analytics com nós de saída
Com conectores do CRM Analytics, você pode gravar o resultado de uma receita para um sistema externo para análise adicional, automação comercial e armazenamento. Depois de configurar um conector de saída para o caminho da pasta e a origem de dados usando as etapas neste guia, crie uma receita usando a Preparação de dados. Adicione um nó de saída à receita e selecione a conexão de saída. Selecione a conexão S3 configurada e escolha qual objeto S3 conterá os dados de saída. Quando a receita é executada, o CRM Analytics grava os dados no objeto especificado no caminho da pasta dentro do diretório. Por exemplo, se você especificou o caminho da pasta ...support/servicedata e escolheu o objeto APAC, nós gravamos na pasta APAC no caminho ...support/servicedata/APAC. A nova pasta contém estes arquivos:
- O arquivo de conjunto de dados de saída .csv, com o padrão de nomenclatura
folderpath_0.csv. No nosso exemplo, a saída éAPAC_0.csv. Para conjuntos de dados maiores, o CRM Analytics particiona automaticamente os dados em vários arquivos .csv com números crescentes acrescentados ao nome. No nosso exemplo, pode haver umAPAC_1.csv, umAPAC_2.csve mais até que todos os dados sejam gravados. Esse arquivo não tem uma linha de cabeçalho. - O arquivo de metadados schema.json, com informações em cada coluna, incluindo nome, tipo de dados e precisão.
- O arquivo _SUCCESS, gerado quando um .csv é totalmente gravado.
Quando você executa a receita novamente, os arquivos gerados anteriormente são excluídos e a nova versão dos arquivos é gravada.
Habilitar e adicionar o conector de saída do Amazon S3
- Em Configuração, na caixa Busca rápida, insira Analytics, selecione Analytics e então Configurações.
- Selecione Habilitar conexão de saída do Amazon S3 e salve suas alterações.
- No gerenciador de dados, clique na guia Conexões.
- Clique em Nova conexão.
- Clique em Saída.
- Clique no ícone do conector e insira suas configurações conforme descrito na seção Configurações de conexão.
- Clique em Salvar e testar. Salvar e testar valida suas configurações tentando conectar-se à origem. Se a conexão falhar, o CRM Analytics mostrará os possíveis motivos.
Todas as configurações exigem um valor, a menos que indicado de outra forma.
| Configuração de conexão | Descrição |
|---|---|
| Nome da conexão | Identifica a conexão. Use uma convenção que permita distinguir facilmente as diferentes conexões. |
| Nome do desenvolvedor (Developer Name) | Nome de API da conexão. O nome do desenvolvedor não pode incluir espaços e não é possível alterá-lo depois de criar a conexão. |
| Descrição | Descrição |
| Tipo de autenticação | Para autenticação padrão, insira Raiz. Para autenticação do Gerenciamento de acesso de identidade (IAM) da AWS, insira IAM. Para acesso granular a dados da AWS, use a autenticação do IAM, configurando usuários e papéis do IAM na AWS. Para obter mais informações sobre o AWS IAM, consulte Introdução ao IAM na AWS |
| Chave secreta | Sua chave de acesso secreta da Amazon. |
| Nome da região | Região do seu serviço S3. A região padrão é o Leste dos EUA (N.Virginia). Para obter a lista de nomes de região, consulte a documentação de Pontos de extremidade de serviço da AWS. |
| Caminho da pasta | Caminho da pasta à qual você deseja se conectar. O caminho da pasta deve começar com o nome do grupo e não pode incluir o nome da subpasta cujos dados você deseja sincronizar. |
| Chave de acesso | ID da chave de acesso ao seu grupo Amazon S3. |
| ARN do papel da AWS | Somente para autenticação IAM, o ARN do papel IAM. Você pode encontrá-lo na Configuração de papel do IAM na AWS. |
Lembre-se destes comportamentos ao trabalhar com o conector de saída do Amazon S3.
- Você pode usar uma conexão de saída mais de uma vez por receita, mas cada nó de saída deve usar um objeto diferente. Cada nó de saída pode utilizar até o limite por execução do conector de modo independente, mas ainda está sujeito ao limite de 24 horas dinâmico.
- As conexões de saída estão disponíveis apenas para receitas criadas com o Preparador de dados.
- Cada conexão de saída tem suporte para apenas um caminho de pasta. Para enviar para outro caminho de pasta, crie outra conexão de saída.
- Quando os arquivos da execução anterior são excluídos na preparação para a execução atual, a versão anterior de um conjunto de dados de saída fica inacessível. Configure um processo para copiar ou usar a saída após cada execução e use o arquivo _SUCCESS como uma indicação de que a gravação foi concluída.
- Os valores nulos são enviados para a AWS como
null-[token], em que o token é uma string de caracteres. Por exemplo,null-OrJLA4JEfCjToa4DDNounull-PaKIW3MEfCaQou9WXM. Para interpretar os valores nulos, talvez seja necessário implementar pós-processamento usando a AWS CLI ou no destino em que os dados são consumidos.
