DataWorks:Métricas atômicas

Pré-requisitos

Crie um domínio de dados e um processo de negócio para definir as atividades a analisar. Para mais informações, consulte Planejamento de negócios.

Visão geral

A métrica atômica é a menor unidade de medida na Modelagem Inteligente de Dados. Ela define o que calcular e como calcular para um determinado comportamento de negócio.

Uma métrica atômica consiste em duas partes:

• Informações básicas: atributos fundamentais e definição de negócio, geralmente um campo numérico em uma tabela de fatos, como amt (valor).

• Lógica de cálculo (Função de Agregação): método de cálculo, como SUM, COUNT, AVG, MAX ou MIN.

A métrica atômica é indivisível: sua definição não inclui qualificadores de negócio, como períodos de tempo ou canais de origem. Ela serve como base para construir métricas derivadas e indicadores compostos.

Criar uma métrica atômica

1. Acesse a página Atomic Metric.

   1. Faça login no console do DataWorks. Na região desejada, clique em Data Development and O&M > Data Modeling no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Modeling.

   2. Na página Data Modeling, clique em Data Metrics na barra de navegação superior.

   3. Na página Data Metrics, clique em Atomic Metric no painel de navegação à esquerda para acessar a página Atomic Metric.

2. Crie a métrica atômica.

   1. Na página Atomic Metric, clique no ícone para criar uma nova métrica atômica.

3. Configure a métrica atômica.

   1. Defina as informações básicas.

      Consulte a tabela abaixo para entender os parâmetros de informações básicas.

      Parâmetro	Descrição
      Abbreviation	Abreviação da métrica atômica, usada como identificador único. Este valor não pode ser alterado após a criação.
      Name	Nome da métrica atômica. Use um nome descritivo que transmita claramente o propósito da métrica.
      Display Name	Nome de exibição da métrica atômica. Escolha um nome descritivo que indique com clareza a finalidade da métrica.
      Effective Scope	Define o escopo estatístico da atividade de negócio para evitar ambiguidades durante a análise. Por exemplo, a definição de negócio para valor real de pagamento do pedido pode ser: The total amount that a user pays through a payment channel after an order is generated. This amount is the total sum that the user actually pays after all discounts and coupons are applied.
      Business Category	Categoria de negócio associável a um domínio de dados ou a um data mart.
      Business Process	Processo de negócio ao qual a métrica atômica pertence; define a atividade empresarial a analisar.
      Owner	Proprietário da métrica atômica. Por padrão, é o usuário que cria a métrica.
      Description	Descrição detalhada da métrica atômica.

   2. Configure a lógica de cálculo.

      A lógica de cálculo define apenas o método e a unidade de medida. Escreva o código para implementar o cálculo efetivo. A tabela a seguir descreve os parâmetros disponíveis.

      Parâmetro	Descrição
      Function	Selecione a função de agregação para o cálculo.
      Decimal Places	Número de casas decimais, determinado pela unidade de medida selecionada. Por exemplo, ao medir um valor de pagamento em yuan, defina o número de casas decimais como 2.
      Data Unit	Escolha uma unidade de medida com base no tipo de dado da métrica atômica. Por exemplo, para um valor de pagamento, selecione currency unit. Nota Caso os tipos de unidade existentes não atendam às suas necessidades, crie uma nova na página de unidades de medida. Para mais informações, consulte unidade de medida.
      Deduplication	Define se os valores devem ser deduplicados durante a análise. Por exemplo, se a métrica atômica for o número de membros, remova duplicatas em vez de simplesmente somar os valores.

4. Clique em Save.

5. Clique em Submit para publicar a versão atual da métrica atômica. Apenas métricas atômicas enviadas podem ser referenciadas por modelos e métricas derivadas.

   Nota

   • Somente métricas atômicas salvas podem ser enviadas.

   • Cada envio de uma métrica atômica gera uma nova versão. Uma versão enviada não pode ser modificada ou reenviada.

Gerenciamento de versões e tabelas associadas

Importar métricas atômicas

Para criar várias métricas atômicas simultaneamente, use o recurso de importação em lote. O DataWorks fornece um modelo para preenchimento e upload.

1. Na página Atomic Metric, passe o mouse sobre o ícone e clique em Import from Excel.

   Para obter informações sobre como navegar até a página de métricas atômicas, consulte as etapas na seção "Criar uma métrica atômica".

2. Selecione um tipo de importação e baixe o modelo.

   Na aba Confirm Import Type, escolha o tipo de importação, baixe o modelo e preencha-o.

   Nota

   Após selecionar o tipo de importação, visualize o modelo para preparar o conteúdo necessário.

   O modelo de importação de métricas atômicas inclui os seguintes campos: Business category, Business process, Abbreviation, Display name, Name, Function, Decimal places e Measurement unit.

3. Importe e confirme os dados.

   Na aba Data Import, carregue e visualize o arquivo de dados. Filtre para exibir apenas campos com nomes iguais aos já existentes no DataWorks e, em seguida, exclua ou modifique as duplicatas.

   • O Import Mode e o Import Status dependem do tipo de importação selecionado.

     • Import Mode: Se um objeto importado tiver o mesmo nome de um objeto existente no DataWorks, ignore a importação ou sobrescreva o objeto existente.

     • Import Status:

       • Import and Save: Importa e salva os dados sem criar uma nova versão.

       • Import and Submit: Importa os dados e os envia como uma nova versão.

   • A importação em lote aceita apenas arquivos .xlsx. É possível importar até 30.000 registros de dados por vez, e o tamanho do arquivo não pode exceder 10 MB.

   A tabela de visualização do arquivo inclui as seguintes colunas: Business category, Business process, Abbreviation, Display name, Name, Function, Decimal places e Measurement unit. Após confirmar que os dados estão corretos, clique em confirm import.

   • Verifique o resultado da importação.

     Na aba Complete, visualize os detalhes da importação. Na lista de detalhes, clique em View More Details ao lado de uma métrica atômica para acessar sua página de edição. Se a importação falhar, trate a exceção com base nos detalhes do erro e importe os dados novamente.

   Exportar métricas atômicas

   Para exportar um grande número de métricas atômicas, use o recurso de exportação em lote. Na página de lista de métricas atômicas, clique em export all para exportar todas as métricas ou selecione métricas específicas e clique em batch export para exportar apenas as selecionadas.

   1. Acesse a página de lista de métricas atômicas.

      Na página de métricas atômicas, clique duas vezes no ícone acima da árvore de diretórios à esquerda para ir à lista de métricas atômicas, onde é possível visualizar todas as métricas criadas.

   2. Selecione as métricas a exportar.

      Nota

      Esta etapa não é necessária se você usar a opção Export All.

      Selecione as métricas de duas maneiras:

      • Pesquisar por palavra-chave: Insira uma palavra-chave na caixa de pesquisa para encontrar as métricas desejadas.

        Nota

        Há suporte para pesquisa aproximada. Após inserir uma palavra-chave, todas as métricas atômicas cujos nomes contenham essa palavra serão exibidas.

      • Selecionar diretamente: Marque as caixas de seleção das métricas necessárias.

   3. Exporte as métricas atômicas em lote.

      Exporte as métricas de uma das três formas a seguir:

      • Export All: Exporta todas as métricas atômicas criadas no workspace atual.

      • Export Searched Objects: Pesquise as métricas desejadas inserindo uma palavra-chave. Este método exporta todos os resultados correspondentes.

      • Export Selected Objects: Selecione as métricas desejadas. Este método exporta todas as métricas selecionadas.

   4. Visualize e baixe o resultado da exportação.

      Ao iniciar uma tarefa de exportação, você será redirecionado para a página Atomic Metric Export Status Details para acompanhar o status. Quando a exportação for concluída com sucesso, clique em Download File para baixar as métricas atômicas para o seu dispositivo local.

   Exclusão e envio em lote

   Se houver múltiplas métricas atômicas não utilizadas ou métricas salvas mas não enviadas, acesse a página de lista de métricas atômicas para realizar exclusões ou envios em lote.

   1. Acesse a página de lista de métricas atômicas.

      Na página de métricas atômicas, clique duas vezes no ícone acima da árvore de diretórios à esquerda para ir à lista de métricas atômicas, onde é possível visualizar todas as métricas criadas.

   2. Selecione as métricas para a operação em lote.

      Nota

      Para envio em lote, selecione apenas métricas atômicas salvas, mas ainda não enviadas.

   3. Escolha excluir ou enviar as métricas em lote.

      • Batch Delete: Métricas excluídas não podem ser associadas ou referenciadas por modelos e métricas derivadas.

        Nota

        Se uma métrica atômica estiver sendo referenciada por um modelo ou métrica derivada, remova a referência antes de excluir a métrica.

      • Batch Submit: Métricas enviadas podem ser associadas e referenciadas por modelos e métricas derivadas. Esta ação também gera um novo registro de versão. Para mais informações sobre versões de métricas, consulte Gerenciamento de versões e tabelas associadas.

   Próximas etapas

   Após criar métricas atômicas, referencie-as em métricas derivadas e modelos para medir valores em períodos de tempo, dimensões e condições de negócio específicos. Para mais informações, consulte métricas derivadas e modelos lógicos materializados.