sql_analytic_model_name (para análises detalhadas)

Esta página se refere ao parâmetro sql_analytic_model_name, que faz parte de uma análise detalhada.

sql_analytic_model_name também pode ser usado como parte de uma visualização, conforme descrito na página de documentação do parâmetro sql_analytic_model_name (para visualizações).

Uso

explore: explore_name {
  sql_analytic_model_name: analytic_model_name ;;
}
Hierarquia
explore
sql_analytic_model_name
Valor padrão
Nenhum

Aceita
Um nome de modelo analítico no banco de dados

Regras especiais
  • Os modelos analíticos são compatíveis apenas com conexões do BigQuery e do Snowflake.
  • sql_analytic_model_name para Análises só deve ser usado quando a mesma visualização pode descrever vários modelos analíticos no seu banco de dados.
  • O modelo analítico referenciado por sql_analytic_model_name precisa estar acessível na conexão de banco de dados do modelo.
  • Se o modelo analítico estiver em um banco de dados, esquema, projeto ou conjunto de dados diferente do caminho padrão definido na conexão do banco de dados, defina o escopo do nome do modelo analítico.

Definição

Para conexões do BigQuery e do Snowflake, o parâmetro sql_analytic_model_name especifica o nome de um modelo analítico no banco de dados (um gráfico do BigQuery ou uma visualização semântica no Snowflake) para usar como base de uma análise detalhada da LookML.

Na maioria dos casos, você usa o parâmetro sql_analytic_model_name (para visualizações) para especificar um modelo analítico no arquivo de visualização. Em seguida, nesse arquivo de visualização, defina as dimensões e medidas do LookML com base no modelo analítico do seu banco de dados. No entanto, nos casos em que seu banco de dados tem vários modelos analíticos que podem ser definidos pelos mesmos campos da LookML, use o parâmetro sql_analytic_model_name em um parâmetro explore.

Quando você especifica um sql_analytic_model_name em um parâmetro explore, a análise detalhada substitui o modelo analítico especificado no arquivo de visualização e consulta o modelo analítico especificado no sql_analytic_model_name em explore. Nesse caso, a análise vai usar as medidas e dimensões do LookML definidas no arquivo de visualização, mas vai aplicá-las ao modelo analítico especificado no parâmetro sql_analytic_model_name do parâmetro explore.

Definir o escopo dos nomes de modelos analíticos

Quando você faz referência a um modelo analítico usando apenas o nome dele, o Looker usa o caminho de pesquisa padrão (o banco de dados e o esquema) que o administrador do Looker configurou nas configurações da conexão do banco de dados.

Se você precisar fazer referência a um modelo analítico em um banco de dados e esquema diferente que não esteja no caminho de pesquisa padrão do usuário do banco de dados, use o formato <database_name>.<schema_name>.<analytic_model_name> para apontar para outro banco de dados ou esquema:

  • Para referenciar um modelo analítico de um esquema diferente, use <schema_name>.<analytic_model_name>.
  • Para referenciar um modelo analítico de um banco de dados diferente, use o <database_name>.<schema_name>.<analytic_model_name> completo.

Para uma conexão do Google BigQuery, é possível referenciar um modelo analítico em outro projeto e conjunto de dados definindo o escopo do nome do modelo analítico usando o formato <project_name>.<dataset_name>.<analytic_model_name>. Consulte a página de documentação Conexão do Google BigQuery para mais informações.

Exemplo

Confira um exemplo de uma visualização do LookML chamada MyStoreGraphView, baseada em um gráfico do BigQuery StoreGraph em um banco de dados do BigQuery, incluindo dimensões e medidas mapeadas para o gráfico:

view: MyStoreGraphView {
  sql_analytic_model_name: StoreGraph ;;

  dimension: location_id {
    type: number
    sql: Stores_location_id ;;
  }

  dimension: population {
    type: number
    sql: Locations_population ;;
  }

  dimension: location_name {
    type: string
    sql: Locations_name ;;
  }

  measure: locations_total_population {
    type: number
    sql: Locations_total_population ;;
  }
}

Supondo que o banco de dados tenha outro gráfico chamado ShopDetailsGraph com os mesmos elementos do StoreGraph, confira uma análise detalhada que substitui o valor sql_analytic_model_name no arquivo de visualização MyStoreGraphView. A Análise terá as mesmas dimensões e medidas do LookML definidas no MyStoreGraphView, mas vai consultar o modelo analítico ShopDetailsGraph:

explore: MyStoreGraphView {
  sql_analytic_model_name: ShopDetailsGraph ;;
}

Informações importantes

Considerações sobre modelos analíticos no Looker

Ao usar modelos analíticos no banco de dados, lembre-se das seguintes considerações e limitações:

  • Tipos de dados:somente os seguintes tipos de dados para dimensões e métricas são compatíveis com modelos analíticos:

    • Compatível com dimensões e medidas:
      • string
      • number
      • date
      • yesno
    • Compatível apenas com dimensões:
      • time
      • date_time

  • Medidas:

    • As medidas de base precisam ser predefinidas:no modelo analítico do banco de dados subjacente. O Looker não pode definir uma nova medida de base realizando uma agregação (como type: sum ou type: count) em uma dimensão de um modelo analítico.

    • Medidas baseadas em outras medidas são aceitas:use o parâmetro sql de uma medida do LookML para realizar cálculos não agregados que usam medidas básicas predefinidas do modelo analítico. Ao criar uma métrica com base em outras, não é possível definir a nova métrica como um tipo agregado, como sum ou count. Defina a nova métrica como um tipo não agregado, como string, number, date ou yesno. Veja o exemplo a seguir:

      measure: average_order_amount {
  type: number
  sql: ROUND(${total_order_amount} / NULLIF(${count_orders}, 0), 2) ;;
}

  • Mesclas:uma Análise própria cuja visualização de base é baseada em um modelo analítico não pode incluir mesclas. Da mesma forma, uma visualização baseada em um modelo analítico não pode ser unida a uma Análise detalhada que tenha uma visualização de base padrão do LookML.

  • Junções implícitas:recursos que dependem de junções implícitas não são compatíveis com modelos analíticos. Alguns exemplos de recursos que dependem de junções implícitas são calendários personalizados e campos definidos com type: location, type: distance ou type: zipcode.

  • Os seguintes recursos estão indisponíveis com modelos analíticos:

O modelo analítico precisa estar acessível na conexão atual.

Quando o parâmetro sql_analytic_model_name é usado em um objeto explore, esse objeto explore é incluído em um objeto model. A hierarquia nesta página mostra essa cadeia de relacionamento. O objeto do modelo tem um connection de banco de dados definido nele. Quando você faz referência a um modelo analítico no parâmetro sql_analytic_model_name, ele precisa estar acessível na conexão associada especificada no arquivo do modelo.

O banco de dados e o esquema padrão (ou, para o Google BigQuery, o projeto de faturamento e o conjunto de dados) são definidos pelo administrador do Looker ao criar a conexão do Looker com seu banco de dados.