Beta

(Beta) Usar campos calculados para exportar matrizes em arquivos de esquema simples use-calculated-fields-to-export-arrays-in-flat-schema-files

AVAILABILITY
  • A funcionalidade para exportar matrizes por meio de campos calculados está atualmente em Beta. A documentação e a funcionalidade estão sujeitas a alterações.

Saiba como exportar matrizes por meio de campos calculados do Real-Time CDP em arquivos de esquema simples para destinos de armazenamento na nuvem. Leia este documento para entender os casos de uso ativados por essa funcionalidade.

Obtenha informações abrangentes sobre campos calculados - o que são e por que são importantes. Leia as páginas vinculadas abaixo para obter uma introdução aos campos calculados no Preparo de dados e mais informações sobre todas as funções disponíveis:

IMPORTANT
Nem todas as funções listadas acima são suportadas ao exportar campos para destinos de armazenamento na nuvem usando a funcionalidade de campos calculados. Consulte a seção funções suportadas mais abaixo para obter mais informações.

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

No Experience Platform, é possível usar Esquemas XDM para gerenciar diferentes tipos de campo. Anteriormente, era possível exportar campos simples de tipo de par de valor-chave, como cadeias de caracteres de Experience Platform, para os destinos desejados. Um exemplo de um campo compatível com a 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 usuário do Experience Platform. Além dos tipos de campo suportados anteriormente, agora é possível exportar objetos de matriz como: organizations:[marketing, sales, engineering]. Veja mais abaixo exemplos abrangentes Saiba como você pode usar várias funções para acessar elementos de matrizes, unir elementos de matriz em uma sequência e muito mais.

Limitações conhecidas known-limitations

Observe as seguintes limitações conhecidas da versão beta dessa funcionalidade:

  • No momento, não há suporte para a exportação para arquivos JSON ou Parquet com esquemas hierárquicos. Você pode exportar matrizes somente para arquivos CSV de esquema simples, JSON e Parquet.
  • Nesse momento, você só pode exportar matrizes simples (ou matrizes de valores primitivos) para destinos de armazenamento na nuvem. Isso significa que você pode exportar objetos de matriz que incluem valores de string, int ou booleanos. Não é possível exportar mapas ou matrizes de mapas ou objetos. A janela modal de campos calculados exibe apenas as matrizes que você pode exportar.

Pré-requisitos prerequisites

Conectar para um destino de armazenamento na nuvem desejado, avance através da etapas de ativação para destinos do cloud storage e acesse o mapeamento etapa.

Como exportar campos calculados how-to-export-calculated-fields

Na etapa de mapeamento do fluxo de trabalho de ativação para destinos de armazenamento na nuvem, selecione (Beta) Adicionar campo calculado.

Adicione o campo calculado realçado na etapa de mapeamento do fluxo de trabalho de ativação em lote.

Essa ação abre uma janela modal onde é possível selecionar atributos que você pode usar para exportar atributos do Experience Platform.

IMPORTANT
Somente alguns campos do esquema XDM estão disponíveis no Campo exibição. Você pode ver valores de string e matrizes de string, int e valores booleanos. Por exemplo, a variável segmentMembership matriz não é exibida, pois inclui outros valores de matriz.

Janela modal da funcionalidade de campo calculado com nenhuma função selecionada ainda.

Por exemplo, use o join na loyaltyID como mostrado abaixo para exportar uma matriz de IDs de fidelidade como uma string concatenada com um sublinhado em um arquivo CSV. Exibir mais informações sobre este e outros exemplos abaixo.

Janela modal da funcionalidade de campo calculado com a função de junção selecionada.

Selecionar Salvar para manter o campo calculado e retornar à etapa de mapeamento.

Janela modal da funcionalidade de campo calculado com a função de junção selecionada e o controle Salvar realçado.

De volta à etapa de mapeamento do fluxo de trabalho, preencha o Campo de destino com um valor do cabeçalho da coluna que você deseja para esse campo nos arquivos exportados.

Etapa de mapeamento com o campo de destino realçado.

Selecionar campo de destino 2

Quando estiver pronto, selecione Próxima para prosseguir para a próxima etapa do fluxo de trabalho de ativação.

Etapa de mapeamento com o campo de destino realçado e um valor de destino preenchido.

Funções compatíveis supported-functions

Observe que somente as seguintes funções são compatíveis com a versão beta de campos calculados e com a matriz de suporte para destinos:

  • join
  • coalesce
  • size_of
  • iif
  • index-based array access
  • add_to_array
  • to_array
  • first
  • last
  • sha256
  • md5

Exemplos de funções usadas para exportar matrizes examples

Consulte exemplos e informações adicionais nas seções abaixo para algumas das funções listadas acima. Para o restante das funções listadas, consulte a documentação de funções gerais na seção Preparo de dados.

join função para exportar matrizes join-function-export-arrays

Use o join para concatenar os elementos de uma matriz em uma string, usando um separador desejado, como _ ou |.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento usando um join('_',loyalty.loyaltyID) sintaxe:

  • "organizations": ["Marketing","Sales,"Finance"] matriz
  • person.name.firstName string
  • person.name.lastName string
  • personalEmail.address string

Exemplo de mapeamento incluindo a função join.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os três elementos da matriz são concatenados em uma única string usando o _ caractere.

`First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "Marketing_Sales_Finance"

iif função para exportar matrizes iif-function-export-arrays

Use o iif para exportar elementos de uma matriz em determinadas condições. Por exemplo, continuar com a variável organizations do objeto de matriz acima, você pode gravar uma simples função condicional como iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing").

Exemplo de mapeamento incluindo a função iif.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Nesse caso, o primeiro elemento do array é Marketing, então a pessoa é um membro do departamento de marketing.

`First_Name,Last_Name, Personal_Email, Is_Member_Of_Marketing_Dept
John,Doe, johndoe@acme.org, "isMarketing"

add_to_array função para exportar matrizes add-to-array-function-export-arrays

Use o add_to_array para adicionar elementos a uma matriz exportada. É possível combinar essa função com a variável join descrita mais acima.

Continuando com o organizations do objeto de matriz acima, você pode gravar uma função como source: join('_', add_to_array(organizations,"2023")), que devolve as organizações das quais uma pessoa é membro em 2023.

Exemplo de mapeamento incluindo a função add_to_array.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os três elementos da matriz são concatenados em uma única string usando o _ e 2023 também estão anexados ao final da cadeia de caracteres.

`First_Name,Last_Name,Personal_Email,Organization_Member_2023
John,Doe, johndoe@acme.org,"Marketing_Sales_Finance_2023"

coalesce função para exportar matrizes coalesce-function-export-arrays

Use o coalesce função para acessar e exportar o primeiro elemento não nulo de uma matriz em uma cadeia de caracteres.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento usando um coalesce(subscriptions.hasPromotion) sintaxe para retornar o primeiro true de false valor na matriz:

  • "subscriptions.hasPromotion": [null, true, null, false, true] matriz
  • person.name.firstName string
  • person.name.lastName string
  • personalEmail.address string

Exemplo de mapeamento incluindo a função de união.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como a primeira variável não nula true na matriz é exportado no arquivo.

First_Name,Last_Name,hasPromotion
John,Doe,true

size_of função para exportar matrizes sizeof-function-export-arrays

Use o size_of função para indicar quantos elementos existem em uma matriz. Por exemplo, se você tiver uma purchaseTime objeto de matriz com vários carimbos de data e hora, você pode usar o size_of função para indicar quantas compras separadas foram feitas por uma pessoa.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento.

  • "purchaseTime": ["1538097126","1569633126,"1601255526","1632791526","1664327526"] array indicando cinco tempos de compra separados pelo cliente
  • personalEmail.address string

Exemplo de mapeamento incluindo a função size_of.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como a segunda coluna indica o número de elementos na matriz, correspondente ao número de compras separadas feitas pelo cliente.

`Personal_Email,Times_Purchased
johndoe@acme.org,"5"

Acesso ao array baseado em índice index-based-array-access

Você pode acessar um índice de uma matriz para exportar um único item da matriz. Por exemplo, semelhante ao exemplo acima para o size_of função, se você quiser acessar e exportar apenas a primeira vez que um cliente comprar um determinado produto, será possível usar purchaseTime[0] para exportar o primeiro elemento do carimbo de data e hora, purchaseTime[1] para exportar o segundo elemento do carimbo de data e hora, purchaseTime[2] para exportar o terceiro elemento do carimbo de data e hora etc.

Exemplo de mapeamento que mostra como um elemento de uma matriz pode ser acessado.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo, exportando a primeira vez que o cliente fez uma compra:

`Personal_Email,First_Purchase
johndoe@acme.org,"1538097126"

first e last funções para exportar matrizes first-and-last-functions-export-arrays

Use o first e last funções para exportar o primeiro ou o último elemento em uma matriz. Por exemplo, continuar com a variável purchaseTime objeto de matriz com vários carimbos de data e hora dos exemplos anteriores, você pode usá-los para funções do para exportar a primeira ou a última compra feita por uma pessoa.

Exemplo de mapeamento incluindo a primeira e a última funções.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo, exportando a primeira e a última vez que o cliente fez uma compra:

`Personal_Email,First_Purchase, Last_Purchase
johndoe@acme.org,"1538097126","1664327526"

Funções de hash hashing-functions

Além das funções específicas para exportar matrizes ou elementos de uma matriz, você pode usar funções de hash para hash de atributos nos arquivos exportados. Por exemplo, se você tiver informações de identificação pessoal nos atributos, é possível aplicar hash a esses campos ao exportá-los.

Por exemplo, é possível aplicar hash a valores de string diretamente md5(personalEmail.address). Se desejar, também é possível aplicar hash a elementos individuais de campos de matriz, supondo que os elementos na matriz sejam cadeias de caracteres, desta forma: md5(purchaseTime[0])

As funções de hash compatíveis são:

Função
Exemplo de expressão
sha1
sha1(organizations[0])
sha256
sha256(organizations[0])
sha512
sha512(organizations[0])
hash
hash("crc32", organizations[0], "UTF-8")
md5
md5(organizations[0], "UTF-8")
crc32
crc32(organizations[0])
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6