Azure Blob conexão
Log de alterações de destino changelog
Com a versão de Experience Platform de julho de 2023, o destino Azure Blob fornece nova funcionalidade, 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
Azure Blob (a seguir denominado Blob) é a solução de armazenamento de objetos da Microsoft para a nuvem. Este tutorial fornece etapas para a criação de um destino Blob usando a interface do usuário Platform.
Conecte-se ao seu armazenamento do Azure Blob por meio da API ou da interface connect-api-or-ui
- Para se conectar ao local de armazenamento do Azure Blob usando a interface do usuário da Platform, leia as seções Conectar-se ao destino e Ativar públicos-alvo para este destino abaixo.
- Para se conectar ao seu local de armazenamento do Azure Blob de forma programática, leia o Tutorial da API do Serviço de Fluxo para ativar públicos para destinos baseados em arquivo.
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 sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de 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 destino Blob válido, ignore o restante deste documento e prossiga para o tutorial em ativando públicos para o seu destino.
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-alvo, a Platform cria um arquivo .csv, parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção 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 arquivo .parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção verificar exportação bem-sucedida do conjunto de dados no tutorial exportar conjuntos de dados.
Conectar ao destino connect
Para se conectar a este 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.
-
Cadeia de conexão: a cadeia de conexão é necessária para acessar dados no armazenamento Blob. O padrão da cadeia de conexão Blob começa com:
DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.- Para obter mais informações sobre como configurar sua cadeia de conexão Blob, 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 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: insira um nome que o ajudará a identificar este destino.
-
Descrição: insira uma descrição deste destino.
-
Caminho da pasta: insira o caminho para a pasta de destino que hospedará os arquivos exportados.
-
Contêiner: insira o nome do contêiner Azure Blob Storage que será usado por este destino.
-
Tipo de arquivo: selecione o Experience Platform de formato que deve ser usado para os arquivos exportados. Ao selecionar a opção 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, tamanho da exportação e muito mais. O manifesto é nomeado usando o formato
manifest-<<destinationId>>-<<dataflowRunId>>.json. Exibir um arquivo de manifesto de exemplo. O arquivo de manifesto inclui os seguintes campos:flowRunId: A 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 onde 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.
Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.
Ativar públicos-alvo para esse destino activate
- Para ativar dados, você precisa de Exibir Destinos, Ativar Destinos, Exibir Perfis e Exibir Segmentos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.
- Para exportar identidades, você precisa da permissão Exibir Gráfico de Identidade 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 do Azure Blob e se os arquivos exportados contêm as populações de perfis esperadas.