Conexão SFTP
Log de alterações de destino changelog
Com a versão de Experience Platform de julho de 2023, o destino SFTP fornece novas funcionalidades, conforme listado abaixo:
- Suporte à exportação de conjuntos de dados.
- Opções de nomenclatura de arquivo adicionais.
- Capacidade de definir cabeçalhos de arquivos personalizados em seus arquivos exportados por meio da etapa de mapeamento aprimorado.
- Capacidade de personalizar a formatação de arquivos de dados CSV exportados.
Visão geral overview
Crie uma conexão de saída ativa com o servidor SFTP para exportar arquivos de dados delimitados da Adobe Experience Platform periodicamente.
Conectar-se ao SFTP por meio da API ou da interface connect-api-or-ui
- Para se conectar ao local de armazenamento SFTP 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 local de armazenamento SFTP de forma programática, leia o Ative públicos 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 de configuração de destino, preencha os campos listados nas duas seções abaixo.
Informações de autenticação authentication-information
Se você selecionar a variável SFTP com senha tipo de autenticação para se conectar ao local SFTP:
-
Domínio: o endereço do local de armazenamento SFTP;
-
Nome de usuário: o nome de usuário para fazer logon no local de armazenamento SFTP;
-
Porta: a porta usada pelo local de armazenamento SFTP;
-
Senha: a senha para fazer logon no local de armazenamento SFTP.
-
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.
Se você selecionar a variável SFTP com chave SSH tipo de autenticação para se conectar ao local SFTP:
-
Domínio: Preencha o endereço IP ou o nome de domínio da conta SFTP
-
Porta: a porta usada pelo local de armazenamento SFTP;
-
Nome de usuário: o nome de usuário para fazer logon no local de armazenamento SFTP;
-
Chave SSH: a chave SSH privada usada para fazer logon no local de armazenamento SFTP. A chave privada deve ser uma string com formato RSA e codificação Base64, e não deve ser protegida por senha.
-
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.
Detalhes do destino destination-details
Depois de estabelecer a conexão de autenticação com o local SFTP, forneça as seguintes informações para o destino:
-
Nome: insira um nome que ajude a identificar esse destino na interface do usuário do Experience Platform;
-
Descrição: insira uma descrição para esse destino;
-
Caminho da pasta: digite o caminho para a pasta no local SFTP onde os arquivos serão 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 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 o armazenamento SFTP e 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.