Conexão com o Azure Blob

Log de alterações de destino

Com a versão de julho de 2023 do Experience Platform, a Azure Blob O destino 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

Azure Blob (a seguir designado Blob) é a solução de armazenamento de objetos da Microsoft para a nuvem. Este tutorial fornece etapas para a criação de um Blob destino usando o Platform interface do usuário.

Conecte-se ao seu Azure Blob armazenamento por meio da API ou da interface

• Para se conectar ao seu Azure Blob 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 Azure Blob local de armazenamento de dados de forma programática, leia as Ative públicos para destinos baseados em arquivo usando o tutorial da API do Serviço de fluxo.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:

• Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
  • Noções básicas da composição do esquema: saiba mais sobre os componentes básicos dos esquemas XDM, incluindo princípios fundamentais e práticas recomendadas na composição do esquema.
  • Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
• Real-Time Customer Profile: fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.

Se você já tiver um Blob destino, você pode ignorar o restante deste documento e prosseguir para o tutorial em ativação de públicos-alvo para o seu destino.

Públicos-alvo compatíveis

Esta seção descreve que tipo de público-alvo você pode exportar para esse destino.

Tipo e frequência de exportação

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Formatos de arquivo não compatíveis

Experience Platform O suporta o seguinte formato de arquivo a ser exportado para o Azure Blob:

• Valores separados por vírgula (CSV): no momento, o suporte para arquivos de dados exportados está limitado a valores separados por vírgula.

Conectar ao destino

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

Para autenticar no destino, preencha os campos obrigatórios e selecione Conectar ao destino.

• String de conexão: a cadeia de conexão é necessária para acessar dados no armazenamento de Blob. A variável Blob o padrão da cadeia de conexão começa com: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.

  • Para obter mais informações sobre como configurar o Blob sequência de conexão, consulte Configurar uma cadeia de conexão para uma conta de armazenamento do Azure na documentação do Microsoft.

• 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

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.
• Caminho da pasta: insira o caminho para a pasta de destino que hospedará os arquivos exportados.
• Container: Insira o nome do Azure Blob Storage contêiner a ser usado por este destino.
• 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

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

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.

Exportar conjuntos de dados

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:

• Como exportar conjuntos de dados usando a interface do usuário da Platform.
• Como exportar conjuntos de dados de forma programática usando a API do Serviço de fluxo.

Dados exportados

Para Azure Blob Storage destinos, Platform cria um .csv no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte Ativar dados do público-alvo para destinos de exportação de perfil em lote no tutorial de ativação de público-alvo.