Loading
CRM Analytics
Conexão de saída do Amazon S3

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.

Nota
Nota Se você quiser sincronizar dados de um bucket do Amazon S3 para o CRM Analytics, use uma Conexão do Amazon S3.

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 um APAC_1.csv, um APAC_2.csv e 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

  1. Em Configuração, na caixa Busca rápida, insira Analytics, selecione Analytics e então Configurações.
  2. Selecione Habilitar conexão de saída do Amazon S3 e salve suas alterações.
  3. No gerenciador de dados, clique na guia Conexões.
  4. Clique em Nova conexão.
  5. Clique em Saída.
  6. Clique no ícone do conector e insira suas configurações conforme descrito na seção Configurações de conexão.
  7. 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-OrJLA4JEfCjToa4DDN ou null-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.
 
Carregando
Salesforce Help | Article