sql_analytic_model_name (para análises detalhadas)

Pré-lançamento: esse recurso está sujeito aos Termos da solução pré-GA na seção Termos gerais de serviço dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se você encontrar um problema durante a prévia pública da interoperabilidade do Looker com modelos analíticos, informe o problema para [e-mail].

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

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 Arquivo de modelo 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 puder descrever vários modelos analíticos no 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 de banco de dados, você precisará definir o escopo do nome do modelo analítico.

Definição

Para conexões do BigQuery e do Snowflake, o sql_analytic_model_name parâmetro 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) a ser usado como base para uma Análise do LookML.

Na maioria dos casos, você usa o sql_analytic_model_name (para visualizações) parâmetro para especificar um modelo analítico no arquivo de visualização. Em seguida, nesse arquivo de visualização, você define dimensões e medições do LookML com base no modelo analítico do banco de dados. No entanto, nos casos em que o banco de dados tem vários modelos analíticos que podem ser definidos pelos mesmos campos do LookML, você pode usar 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 substitui o modelo analítico especificado no arquivo de visualização e consulta o modelo analítico especificado no sql_analytic_model_name no parâmetro explore. Nesse caso, a Análise usa as medições e dimensões do LookML definidas no arquivo de visualização, mas as aplica ao modelo analítico especificado no parâmetro sql_analytic_model_name do parâmetro explore.

Definir o escopo de nomes de modelos analíticos

Quando você referencia 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 definições da conexão de banco de dados.

Se você precisar referenciar 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, defina o escopo do nome do modelo analítico usando 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, você pode referenciar um modelo analítico em um projeto e conjunto de dados diferente 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 da conexão do Google BigQuery para mais informações.

Exemplo

Confira um exemplo de visualização do LookML chamada MyStoreGraphView com base em um gráfico StoreGraph do BigQuery em um banco de dados do BigQuery, incluindo dimensões e medições 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 que substitui o valor sql_analytic_model_name no arquivo de visualização MyStoreGraphView. A Análise terá as mesmas dimensões e medições do LookML definidas na 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, tenha em mente as seguintes considerações e limitações:

• Tipos de dados: apenas os seguintes tipos de dados para dimensões e medições são compatíveis com modelos analíticos:

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

• Medições :

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

  • As medições baseadas em outras medições são compatíveis:você pode usar o parâmetro sql de uma medição do LookML para realizar cálculos não agregados que usam medições de base predefinidas do modelo analítico. Ao criar uma medição baseada em outras medições, não é possível definir a nova medição como um tipo de medição agregada, como sum ou count. Você precisa definir a nova medição como um tipo de medição não agregada, 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 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 mesclada em uma Análise que tenha uma visualização de base padrão do LookML.

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

• Os recursos a seguir não são compatíveis com modelos analíticos:

  • Medições filtradas
  • Reconhecimento agregado
  • Runtime legado do Looker

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

Quando o sql_analytic_model_name parâmetro é usado em um explore objeto, esse explore objeto é incluído em um modelo objeto. A hierarquia nesta página mostra essa cadeia de relacionamento. O objeto de modelo tem uma connection de banco de dados definida nele. Quando você referencia um modelo analítico no parâmetro sql_analytic_model_name, o modelo analítico precisa estar acessível na conexão associada especificada no arquivo de 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 o banco de dados.