Nivelar estruturas de dados aninhadas para uso com ferramentas de BI de terceiros

O Serviço de consulta do Adobe Experience Platform oferece suporte à configuração FLATTEN ao conectar-se a um banco de dados por meio de ferramentas de BI de terceiros. Esse recurso nivela as estruturas de dados aninhadas em ferramentas de BI de terceiros para melhorar sua usabilidade e reduzir a carga de trabalho necessária para recuperar, analisar, transformar e relatar dados.

Muitas ferramentas de BI, como o Tableau e o Power BI, não suportam nativamente estruturas de dados aninhadas. A configuração FLATTEN remove a necessidade de criar exibições SQL sobre seus dados para fornecer uma versão simples ou usar os trabalhos do Serviço de Consulta CTAS ou INSERT INTO para duplicar seus conjuntos de dados em versões simples ao usar esquemas ad hoc.

A configuração FLATTEN puxa a estrutura de cada campo folha para a raiz da tabela e nomeia o campo após o namespace original. Isso permite usar a notação de pontos para corresponder um campo ao seu caminho do Modelo de dados de experiência (XDM), preservando o contexto do campo.

Pré-requisitos

O uso da configuração FLATTEN requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:

Conectar a um banco de dados usando a configuração NIVELAR connect-with-flatten

A configuração FLATTEN nivela estruturas de dados aninhadas em colunas separadas, onde o nome do atributo se torna o nome da coluna que contém os valores de linha. Ao trabalhar com dados em ferramentas de BI que não suportam estruturas de dados aninhadas, essa configuração melhora a usabilidade de esquemas ad hoc e reduz a carga de trabalho necessária.

Ao conectar-se ao Serviço de consulta com o cliente de terceiros escolhido, anexe a configuração FLATTEN ao nome do banco de dados. Para obter informações sobre como conectar uma ferramenta de BI específica, consulte sua respectiva documentação na visão geral de conectar clientes ao Serviço de consulta. A cadeia de conexão deve conter:

A entrada deve ter o seguinte formato:

{sandbox_name}:{all/ID/database_name}?FLATTEN

Um exemplo de cadeia de conexão pode ter a seguinte aparência:

prod:all?FLATTEN

Exemplo example

O esquema de exemplo usado neste guia emprega o grupo de campos padrão Detalhes do Commerce, que utiliza a estrutura de objeto commerce e a matriz productListItems. Consulte a documentação do XDM para mais informações sobre o grupo de campos Detalhes do Commerce. Uma representação da estrutura do schema pode ser vista na imagem abaixo.

Se sua ferramenta de BI não suportar estruturas de dados aninhadas, pode ser difícil fazer referência a campos aninhados caso eles contenham valores serializados (como commerce e productListItems no esquema de exemplo). Esses valores podem aparecer como partes de um único campo de cadeia de caracteres commerce codificado e não são realistas.

Os seguintes valores representam commerce.order.priceTotal (3018.0), commerce.order.purchaseID (c9b5aff9-25de-450b-98f4-4484a2170180) e commerce.purchases.value(1.0) em campos aninhados mal formatados.

("(3018.0,c9b5aff9-25de-450b-98f4-4484a2170180)","(1.0)")

Usando a configuração FLATTEN, você pode acessar campos separados em seu esquema ou seções inteiras da estrutura de dados aninhada usando a notação de pontos e seu nome de caminho original. Um exemplo desse formato usando o grupo de campos commerce é fornecido abaixo.

commerce.order.priceTotal
commerce.order.purchaseID
commerce.purchases.value

A configuração FLATTEN tem determinadas limitações ao lidar com outras estruturas de dados. Detalhes completos são fornecidos na seção de limitações.

Usar aspas para campos em consultas quotation-marks

Os campos de raiz nivelada agora usam a notação de pontos para corresponder aos caminhos XDM. Quando usados em uma consulta, os campos precisam estar entre aspas (" ").

O exemplo de SQL abaixo exibe o estado original da consulta aninhada:

SELECT YEAR(timestamp) AS year,
       SUM(commerce.order.priceTotal) AS revenue
FROM purchase_events_dataset
WHERE commerce.purchases.value > 0
GROUP BY 1;

Ao usar os campos de dados nivelados, a consulta é gravada com a notação de pontos e delimitada por aspas, como observado a seguir:

SELECT YEAR(timestamp) AS year,
       SUM("commerce.order.priceTotal") AS revenue
FROM purchase_events_dataset
WHERE "commerce.purchases.value" > 0
GROUP BY 1;

Limitações limitations

No momento, a configuração FLATTEN não nivela as seguintes estruturas de dados:

Para resolver as limitações de Mapa e Array, é necessário usar a edição bruta de SQL das ferramentas de BI, como Opções avançadas -> Instrução SQL no Power BI.

Ferramentas de BI, como edição de SQL bruto, são necessárias para resolver limitações de mapa e de matriz. Consulte o guia sobre como usar as opções avançadas do Power BI para inserir uma consulta SQL personalizada na seção de instrução SQL.

Próximas etapas

Esse documento abordou como nivelar estruturas de dados aninhadas para uso com ferramentas de BI de terceiros. Se você ainda não conectou seu cliente, consulte a visão geral da conexão do cliente para obter uma lista de clientes de terceiros com suporte.