Azure Data Lake Storage Gen2 conexão

Visão geral overview

Leia esta página para saber como criar uma conexão de saída ativa com o seu Azure Data Lake Storage Gen2 (ADLS Gen2) para exportar arquivos de dados do Experience Platform periodicamente.

Conecte-se ao seu ADLS Gen2 armazenamento por meio da API ou da interface connect-api-or-ui

Públicos-alvo compatíveis supported-audiences

Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.

Origem do público
Suportado
Descrição
Segmentation Service
Públicos-alvo gerados pelo Experience Platform Serviço de segmentação.
Uploads personalizados
Públicos-alvo importado para o Experience Platform de arquivos CSV.

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.

Item
Tipo
Notas
Tipo de exportação
Baseado em perfil
Você está exportando todos os membros de um segmento, juntamente com os campos de esquema aplicáveis (por exemplo, o PPID), conforme escolhido na tela Selecionar atributos de perfil da workflow de ativação de destino.
Frequência de exportação
Lote
Os destinos em lote exportam arquivos para plataformas downstream em incrementos de três, seis, oito, doze ou vinte e quatro horas. Leia mais sobre destinos baseados em arquivo em lote.

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

IMPORTANT
Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos 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 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.

  • URL: o endpoint para Azure Data Lake Storage Gen2. O padrão do endpoint é: abfss://<container>@<accountname>.dfs.core.windows.net.

  • Inquilino: as informações do locatário que contêm seu aplicativo.

  • ID principal de serviço: a ID do cliente do aplicativo.

  • Chave principal de serviço: a chave do aplicativo.

  • 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.

    Imagem que mostra um exemplo de uma chave PGP formatada corretamente na interface

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: Preencha o nome preferencial para este destino.

  • Descrição: Opcional. Por exemplo, você pode mencionar para qual campanha está usando 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.

Ativar públicos-alvo para esse destino activate

IMPORTANT

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.

Agendamento scheduling

No Agendamento etapa, você pode configurar o cronograma de exportação para seu Azure Data Lake Storage Gen2 destino e você também pode configurar o nome dos arquivos exportados.

Mapear atributos e identidades map

No Mapeamento etapa, você pode selecionar quais campos de atributo e identidade serão exportados para seus perfis. Você também pode optar por alterar os cabeçalhos no arquivo exportado para qualquer nome amigável. Para obter mais informações, consulte etapa de mapeamento no tutorial ativar interface do usuário de destinos em lote.

Validar exportação de dados bem-sucedida exported-data

Para verificar se os dados foram exportados com êxito, verifique Azure Data Lake Storage Gen2 armazenamento e verifique se os arquivos exportados contêm as populações de perfis esperadas.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6