Exportar arrays, mapas e objetos do Real-Time CDP export-arrays-cloud-storage

Saiba como exportar matrizes, mapas e objetos do Real-Time CDP para destinos de armazenamento na nuvem. Além disso, você pode exportar campos do tipo mapa para destinos corporativos e destinos de personalização de borda limitados. Leia este documento para entender o fluxo de trabalho de exportação, os casos de uso ativados por essa funcionalidade e as limitações conhecidas. Consulte a tabela abaixo para entender a funcionalidade disponível por tipo de destino.

Considere essa página o local de entrada para tudo o que você deseja saber sobre a exportação de arrays, mapas e outros tipos de objetos do Experience Platform.

Vista de baixo à frente

Obtenha as informações mais importantes sobre a funcionalidade nesta seção e prossiga abaixo para as outras seções no documento para obter informações detalhadas.

Matrizes e outros tipos de objetos no Experience Platform arrays-strings-other-objects

No Experience Platform, você pode usar esquemas XDM para gerenciar diferentes tipos de campos. Antes de adicionar suporte a exportações de matriz, você podia exportar campos de tipo de par de valor-chave simples, como cadeias de caracteres do Experience Platform, para os destinos desejados. Um exemplo de um campo com suporte para exportação anterior é personalEmail.address:johndoe@acme.org.

Outros tipos de campo no Experience Platform incluem campos de matriz. Leia mais sobre gerenciamento de campos de matriz na interface do Experience Platform. Agora é possível exportar objetos de matriz, como o exemplo abaixo.

organizations = [{
  id: 123,
  orgName: "Acme Inc",
  founded: 1990,
  latestInteraction: "2024-02-16"
}, {
  id: 456,
  orgName: "Superstar Inc",
  founded: 2004,
  latestInteraction: "2023-08-25"
}, {
  id: 789,
  orgName: 'Energy Corp',
  founded: 2021,
  latestInteraction: "2024-09-08"
}]

Além de matrizes, você também pode exportar mapas e objetos do Experience Platform para o destino de armazenamento na nuvem desejado. Leia mais sobre mapas e objetos no Experience Platform.

Pré-requisitos prerequisites

Conecte a um destino de armazenamento na nuvem desejado. Prossiga pelas etapas de ativação para destinos de armazenamento na nuvem e vá para a etapa mapeamento. Ao se conectar ao destino de nuvem desejado, você deve selecionar a opção Exportar matrizes, mapas, objetos ativada. Obtenha mais informações na seção abaixo.

Botão de alternância Exportar matrizes, mapas e objetos export-arrays-maps-objects-toggle

Ao se conectar a um destino de armazenamento na nuvem baseado em arquivo, você pode ativar ou desativar a Exportar matrizes, mapas, objetos.

Ative esta configuração para habilitar a exportação de matrizes, mapas e objetos para arquivos JSON ou Parquet. Você pode selecionar esses tipos de objeto na exibição de campo de origem da etapa de mapeamento ao ativar públicos para destinos de armazenamento na nuvem. No entanto, com essa configuração ativada, não é possível usar a opção calculated fields para transformar dados na ativação.

Com o botão  desativado, é possível usar a opção de campos calculados e aplicar várias funções de transformação de dados ao ativar públicos-alvo. No entanto, não é possível exportar matrizes, mapas e objetos para arquivos JSON ou Parquet e você deve configurar um destino separado para essa finalidade.

Exportar matrizes, mapas, objetos alternados em export-arrays-maps-objects-toggle-on

Com essa configuração ativada, você pode exportar objetos inteiros (por exemplo, person.name) e matrizes selecionando-os por meio do seletor de campo de origem na etapa de mapeamento do fluxo de trabalho de ativação.

Com essa opção selecionada, a interface impede que os usuários usem campos calculados, e o controle Adicionar campos calculados está desabilitado, conforme mostrado abaixo. Para usar campos calculados para transformações de dados, configure uma conexão de destino com o botão de alternância desativado.

Exportar matrizes, mapas, objetos alternados off export-arrays-maps-objects-toggle-off

Com essa opção definida como off, você pode usar a opção de campos calculados e aplicar várias funções de transformação de dados ao ativar públicos. No entanto, não é possível exportar matrizes, mapas e objetos para arquivos JSON ou Parquet e você deve configurar um destino separado para essa finalidade.

Você pode exportar matrizes, mapas e objetos para arquivos CSV usando a funcionalidade de campos calculados e concatená-los em uma cadeia de caracteres usando a função array_to_string. Leia mais sobre como usar esta função.

Leia mais sobre como trabalhar com campos calculados para executar transformações nos dados exportados para destinos de armazenamento na nuvem.

Arquivos exportados de exemplo sample-exported-files

Usando essa funcionalidade, você pode exportar arquivos Parquet e JSON, nos quais os dados preservam a estrutura do Experience Platform. Veja abaixo um exemplo de um arquivo JSON exportado.

{
  "person_name_firstName": "John",
  "person_name_lastName": "Smith",
  "_acmeinc_customer_hs_main_address_scalar": "Oak Avenue No 12",
  "_acmeinc_customer_hs_locations_array": [
    "home address 12",
    "office address 12"
  ],
  "_acmeinc_customer_hs_date_array": [
    "2024-11-14",
    "2024-11-15"
  ],
  "_acmeinc_customer_hs_customer_obj_emails_array0": "john.smith@example.com",
  "_acmeinc_customer_hs_customer_obj": {
    "emails_array": [
      "john.smith@example.com",
      "j.smith@example.com"
    ],
    "name_scalar": "John Smith"
  },
  "_acmeinc_customer_hs_addresses_array_obj": [
    {
      "is_primary": true,
      "streetName_scalar": "Maple Street",
      "streetNo_int": 12
    },
    {
      "is_primary": false,
      "streetName_scalar": "Pine Road",
      "streetNo_int": 45
    }
  ],
  "_acmeinc_customer_hs_addresses_array_obj0": {
    "is_primary": true,
    "streetName_scalar": "Maple Street",
    "streetNo_int": 12
  }
}