autogenerate_primary_keys

Uso

  autogenerate_primary_keys: yes
Hierarquia
view
autogenerate_primary_keys

- ou -

explore
autogenerate_primary_keys
Valor padrão
Não

Regras especiais

Definição

Quando o parâmetro autogenerate_primary_keys está ativado, o Looker gera uma chave temporária e distinta para uma visualização quando ela não é definida explicitamente no LookML. A chave primária gerada automaticamente permite que agregados simétricos e contagens de um para muitos sejam calculados corretamente sem alterações na tabela do banco de dados subjacente. A chave primária é gerada no tempo de execução da consulta e não é mantida entre consultas.

O parâmetro autogenerate_primary_keys tem suporte para visualizações e análises:

  • Para visualizações, se você definir a visualização com autogenerate_primary_keys: yes, o Looker vai gerar uma chave primária para consultas na visualização em que uma chave primária é necessária para evitar a duplicação de linhas. Se você adicionar autogenerate_primary_keys: yes a uma visualização que já tem um campo definido como chave primária, o Looker IDE vai mostrar um aviso de validação do LookML.

  • Para análises, se você definir a análise com autogenerate_primary_keys: yes, o Looker vai gerar uma chave primária para cada uma das visualizações da análise que são necessárias para uma consulta de análise em que uma chave primária é necessária para evitar a duplicação de linhas:

    • O Looker gera chaves primárias apenas para as visualizações na análise que não têm um campo definido com primary_key: yes. Se uma visualização tiver um campo definido com primary_key: yes, o Looker vai usar a chave primária da visualização.
    • O Looker gera uma chave primária para uma visualização de análise somente quando a visualização está sendo consultada por essa análise. Se a mesma visualização estiver sendo consultada por uma análise diferente que não está definida com autogenerate_primary_keys: yes, e a visualização em si não estiver definida com autogenerate_primary_keys: yes, o Looker não vai gerar uma chave primária para a visualização.

Exemplo

Confira uma análise de orders que une uma visualização order_items. A análise é definida com autogenerate_primary_keys: yes:

explore: orders {
  autogenerate_primary_keys: yes
  join: order_items {
    sql_on: ${orders.id} = ${order_items.order_id} ;;
    relationship: one_to_many
  }
}

Para consultas na Análise orders que exigem conjuntos simétricos ou cálculos em que as linhas de uma visualização podem ser duplicadas, o Looker gera automaticamente uma chave distinta para as visualizações orders ou order_items.

Informações importantes

Confira o que você precisa saber sobre o uso de autogenerate_primary_keys: yes:

  • A ativação de autogenerate_primary_keys pode mudar o comportamento das suas consultas atuais. As medidas que o Looker precisava remover das consultas devido a uma chave primária ausente agora serão incluídas nos resultados, o que pode ser uma mudança interruptiva para alguns relatórios.
  • A geração automática de chaves primárias pode aumentar o tempo de consulta devido à computação extra necessária.
  • Quando o Looker gera uma chave primária para uma consulta, essa chave primária é uma chave primária de tempo de execução temporária que não pode ser selecionada ou visualizada em uma análise.

Suporte de dialeto para autogenerate_primary_keys

A capacidade de usar autogenerate_primary_keys depende do dialeto do banco de dados que sua conexão do Looker está usando. Na versão mais recente do Looker, os seguintes dialetos oferecem suporte a autogenerate_primary_keys:

  • SQL padrão do Google BigQuery
  • Amazon Redshift
  • Amazon Redshift 2.1 e versões mais recentes
  • Amazon Redshift Serverless 2.1 e versões mais recentes
  • Google Cloud PostgreSQL
  • Greenplum
  • Microsoft Azure PostgreSQL
  • MySQL 8.0.12 e versões mais recentes
  • PostgreSQL anterior à versão 9.5