Catálogo de erros do Looker

A tabela seguinte é uma coleção de algumas mensagens de erro comuns apresentadas no Looker, explicações das respetivas causas subjacentes e onde ocorrem, bem como recursos de resolução de problemas. Os erros são apresentados de acordo com a frequência com que são comunicados ao apoio técnico do Looker, por ordem descendente, começando pelo maior número de pedidos de apoio técnico na parte superior.

A coluna Localização indica onde a mensagem de erro é apresentada no Looker e inclui as seguintes opções (alguns erros podem aparecer em mais do que uma localização no produto):

IDE = Validação de LookML/IDE

Ex = Explorar

SQL = Execução de SQL

LD = Painel de controlo do LookML

D = Painel de controlo

S = Horários

Mensagem de erro Location Causas possíveis Recursos de resolução de problemas
Variable not found (?). IDE
  • A variável Liquid para referência, {{ }}, está aninhada no Liquid para lógica, {% %}.
  • Um filtro baseado em modelos faz referência a uma tabela que não está unida a uma tabela derivada.
  • Um campo referenciado no Liquid não tem o âmbito totalmente definido com um nome de visualização (view_name.field_name).
  • O valor de um filtro é referenciado no interior de outro filtro do painel de controlo do LookML.
  • O valor de um parâmetro parameter não é compatível com o type correspondente. Por exemplo: {% if parameters.change_value._parameter_value == "'AA'" %} Reveja o parameter type para garantir que o valor é avaliado corretamente (type: string em comparação com type: unquoted).
  • Um campo é referenciado corretamente no Liquid como view_name.field_name, mas field_name não está definido na vista com âmbito view_name, ou a vista tem um alias com from num Explorar.
  • Uma referência Liquid a uma variável não está definida ou a referência inclui um erro ortográfico.
  • Uma referência Liquid inclui um grupo de dimensões de type: time, mas não o período específico. Por exemplo, em vez de {{ view_name.creation_date }}, a referência deve usar {{ view_name.creation_date_year }}.
  • Um campo está a usar o Liquid com a sintaxe do operador de substituição do LookML, ${view_name.field_name}, em vez de sem, como view_name.field_name.
Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?). IDE
  • A vista referenciada não existe.
  • Está em falta uma junção, o que torna a vista inacessível a algumas explorações.
  • A visualização de propriedade é renomeada com um parâmetro from numa análise detalhada.
Unknown or inaccessible field (?). Check for typos or append a timeframe to the name if the field is type time. IDE Qualquer uma das causas possíveis indicadas para o erro Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?). pode aplicar-se, além do seguinte:
  • Existe um erro ortográfico num nome de campo ou numa referência ao campo.
  • O campo é excluído de uma análise detalhada pelo parâmetro fields.
  • A referência é a um dimension_group sem um intervalo de tempo especificado.
Unknown view (?). IDE Ex SQL
  • Uma vista não está incluída no ficheiro do modelo.
  • Um explore está a estender uma base explore que não tem um parâmetro view_name.
  • Um nome de exploração definido no parâmetro explore baseia-se num nome de vista com erros ortográficos ou inexistente.
  • Uma consulta do SQL Runner baseada em modelos está a ser executada com o modelo incorreto selecionado.
Unknown view (?). View does not exist in model (?). Check for typos or missing include statements. IDE Ex SQL
  • Um explore está a estender um explore base que não tem um parâmetro view_name, e os campos de qualquer uma das vistas unidas referenciam o nome do explore base.
  • Um campo faz referência a uma vista com erros ortográficos, inexistente ou não associada a explorações aplicáveis.
Unknown field (?) in filter IDE
  • Uma definição de tabela derivada nativa (NDT) inclui um parâmetro bind_all_filters num campo personalizado que não está definido no LookML.
  • Um filtro do LookML faz referência a um campo do LookML que está comentado ou que não existe.
  • Um filtro do LookML faz referência a um campo do LookML de uma vista diferente, e o campo não está totalmente no âmbito nem associado a todos os parâmetros explore relevantes.
Measures with Looker aggregations (sum, average, min, max, list types) may not reference other measures. IDE Uma medida é referenciada na definição SQL de outra medida do tipo agregado.
Unknown view (?). View (?) does not exist in model (?). Check for typos or missing include statements in (?). IDE Uma vista não está incluída num ficheiro de modelo ou está incluída, mas com um erro ortográfico.
Can't construct persistent derived table (?), connection (?) could not be registered IDE Ex
  • Não foi possível criar dependências para um PDT existente.
  • Existe um problema com a ligação, que tem de ser diagnosticado testando a ligação (por exemplo, testar a ligação pode revelar que o utilizador do Looker pode não ter acesso suficiente de propriedade ou gravação à base de dados).
  • Os ficheiros de projeto importados, como uma vista que define o PDT com falhas ou uma vista referenciada pelo PDT com falhas, não estão incluídos no projeto de importação.
  • A ligação à base de dados não tem a definição Tabelas derivadas persistentes ativada.
  • O código de um bloco do Looker não foi atualizado para o dialeto de SQL da ligação, se for diferente do dialeto para o qual o bloco foi escrito.
  • O OAuth está ativado para uma ligação ao Snowflake ou ao BigQuery.
  • Foi definido um valor diferente do valor predefinido, TRUE, para o parâmetro AUTOCOMMIT da base de dados do Snowflake.
Unknown or excluded suggest_dimension (?) in field (?) IDE
  • Um campo referenciado por um parâmetro suggest_dimension não existe, foi comentado ou é excluído numa análise detalhada por um parâmetro fields.
  • Um campo referenciado por um parâmetro suggest_dimension está definido noutra vista, mas não está totalmente no âmbito como view_name.field_name na referência.
  • Um parâmetro suggest_dimension faz referência a um campo numa vista diferente que não está unida a todos os parâmetros explore relevantes ou a uma vista com um alias num explore com um parâmetro from.
A view named (?) has been defined multiple times. Each view in a model must have a unique name. IDE As vistas com nomes idênticos são referenciadas no mesmo modelo, incluindo as vistas importadas para o projeto. Os nomes das vistas têm de ser exclusivos num modelo. Referência do parâmetro view
This include does not match any files IDE
  • Um erro ortográfico no caminho para o ficheiro está a causar um erro.
  • Uma referência de pasta está a usar uma sintaxe incorreta.
  • Uma referência de importação de projeto está a usar uma sintaxe incorreta.
SQL Dialect does not support Symmetric Aggregates with percentiles, field ignored. Ex O dialeto da base de dados não suporta medidas de type: median ou type: percentile com agregações simétricas.
Cannot use native derived table (?) with bind_all_filters outside of its source explore (?) IDE Ex Uma tabela derivada nativa (NDT) com um parâmetro bind_all_filters é unida a uma ou mais explorações que não a exploração definida no parâmetro explore_source. Usar bind_all_filters
Measures of type count do not use the sql parameter. Use count_distinct to count by something other than the primary key, or remove the sql parameter. IDE Um parâmetro sql é usado numa medida de type: count. Os tipos de contagem de medidas fazem uma contagem pela chave principal declarada no ficheiro de visualização e não requerem um parâmetro sql.
An explore named (?) has been defined multiple times. Each explore in a model must have a unique name. IDE LD
  • Um nome de exploração definido no parâmetro explore de um ficheiro de modelo está a duplicar outro nome de exploração existente. Os nomes das explorações têm de ser exclusivos num modelo.
  • Um projeto importado tem um explore com o mesmo nome que um explore existente no projeto de importação.
  • Um ficheiro de modelo incluído tem um explore com o mesmo nome que um explore existente no ficheiro de modelo do projeto de inclusão.*
  • Existe uma referência circular no código, que faz referência ao explore (ou ao ficheiro do modelo) várias vezes.
* Não é uma prática recomendada incluir ficheiros de modelos noutros ficheiros de modelos.
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml? IDE
  • Um modelo está a incluir a pasta de visualização, mas o ficheiro de visualização específico está fora da pasta.
  • Um modelo inclui o nome da vista, mas não o ficheiro de vista, se tiver um nome diferente.
  • Uma vista é unida a um explore várias vezes, mas o parâmetro from está em falta na segunda vez que é unida.
Unknown field '(?)' IDE Ex
  • O campo que está a tentar referenciar não existe, tem um erro ortográfico ou foi comentado.
  • Um campo referenciado está definido numa vista diferente e não está no âmbito do nome da vista.
  • Um campo é definido numa vista diferente que não está associada às explorações necessárias, ou a vista tem um alias numa associação, o que torna o campo inacessível para algumas explorações.
  • Um parâmetro required_fields faz referência a um campo inacessível, com um erro ortográfico, inexistente ou comentado.
Cannot use (?) as access filter since any user can edit their own value. Ex Um atributo do utilizador com a opção Acesso do utilizador definida como Editar é usado no parâmetro access_filter de uma exploração.
label_from_parameter of (?) must refer to a parameter. IDE Ex
  • Um campo referenciado por um parâmetro label_from_parameter não existe, tem um erro ortográfico ou está comentado.
  • Existe um campo referenciado por um parâmetro label_from_parameter, mas não é do tipo parameter.
Cannot use user-editable attribute (?) for access_grant (?) IDE Ex Um atributo do utilizador com a opção Acesso do utilizador definida como Editar é usado no parâmetro access_grant de um ficheiro de modelo.
datagroup (?) has a sql_trigger. This is not allowed in models with a parameterized connection. IDE Uma ligação à base de dados está a usar atributos do utilizador para credenciais de início de sessão na base de dados e a coluna Substituições de PDT não está configurada para um utilizador da base de dados separado para processos de PDT.
relationship missing, assumed to be many_to_one. IDE O relationship de uma junção não está definido. Quando não é especificado um relationship, o Looker assume uma relação many-to-one por predefinição. Referência do parâmetro relationship
No distribution_style specified in persistent derived table (?). Using default distribution style (?). IDE Um PDT de ligação do Redshift não tem um parâmetro distribution_style especificado na respetiva definição de derived_table. Quando não é especificado um distribution_style, o Looker usa o ALL por predefinição. Referência do parâmetro distribution_style
always_filter: unknown filter field '(?)' IDE
  • Um campo referenciado por um parâmetro always_filter não existe, tem um erro ortográfico ou está comentado.
  • Um campo referenciado por um parâmetro always_filter é um dimension_group de type: time que não tem um período anexado.
  • Um campo referenciado por um parâmetro always_filter é um campo definido numa vista que não está unida a todos os parâmetros explore relevantes, ou o campo não está no âmbito do nome da vista.
The location field type requires both sql_latitude and sql_longitude. IDE Um campo de type: location não tem o subparâmetro sql_latitude ou sql_longitude. Os campos do tipo de localização requerem ambos. Referência do tipo de campo location
Missing required sql_step in create_process of derived table '(?)'. IDE
  • Não existe nenhum sql_step especificado no create_process, que requer um ou mais subparâmetros sql_step.
  • Um erro do validador de LookML em cache sinalizou um sql_step em falta, apesar de já ter sido adicionado um sql_step. Valide novamente para resolver o erro.
Referência do parâmetro create_process
Can't construct aggregate table (?), temporary schema for (?) is unset. IDE Ex A definição Tabelas derivadas persistentes não está definida para a associação na página Definições de associação no painel Administração e/ou não existe um esquema de base de dados temporário especificado na definição Base de dados temporária.
Can't construct aggregate table (?), connection (?) could not be registered. IDE Ex A definição Base de dados temporária não está definida na página Definições de ligação do painel Administração, ou o Looker não tem as autorizações adequadas para a base de dados temporária especificada na definição Base de dados temporária.
Unknown view (?) referenced by explore (?) IDE
  • É incluída uma vista com o include: "*.view.lkml" predefinido, mas a vista está numa pasta diferente.
  • O nome de uma vista ou o caminho do ficheiro está com um erro ortográfico numa declaração include, ou a declaração include está a incluir o nome da vista, mas não o ficheiro da vista, se tiver um nome diferente.
  • Existe um problema com carateres especiais, como _views, numa pasta.
  • Um explore está a estender outro explore que não tem um parâmetro view_name que especifica a vista base.
The location field type does not use the sql parameter. Please use sql_latitude and sql_longitude instead. IDE É usado um parâmetro sql num campo de type: location. Os campos do tipo de localização requerem os subparâmetros sql_latitude e sql_longitude em vez do parâmetro sql. Referência do tipo de campo location
A list_field must be defined for measures of type list. IDE Ex Para gerar uma lista a partir de um campo, o campo tem de ser especificado para uma medida de type: list. Referência do tipo de campo list
Query failed with unexpected exception (?) IDE Ex SQL LD D S
  • É especificada uma base de dados diferente da base de dados de ligação principal na coluna Substituições de PDT na página Definições de ligação de uma ligação no painel Administração.
  • O limite de consultas por utilizador foi excedido e uma consulta em fila atingiu o limite de tempo da reserva de ligações.
  • Falha na ligação JDBC.
  • Ocorreu uma falha inesperada da aplicação Looker.
Looker is having trouble connecting to your database. Ex SQL O limite máximo do conjunto de ligações de uma ligação foi atingido e as consultas em fila excederam o tempo limite após o período de tempo limite do conjunto de ligações ter decorrido.
SQL Error in incremental PDT: Query execution failed Ex D S O esquema subjacente foi alterado para uma ou mais tabelas referenciadas num PDT incremental baseado em SQL. A PDT incremental não é criada após a alteração do esquema
Missing dates/values for '(?)' were not filled. Ex
  • Não é possível aplicar o preenchimento da dimensão porque foi selecionada mais do que uma dimensão numa análise detalhada.
  • Não é possível aplicar o preenchimento de dimensões porque um ou mais campos foram dinamizados numa análise detalhada.
  • Não é possível aplicar o preenchimento de dimensões porque um campo tem valores de string distintos (por exemplo, parâmetros allowed_value ou case) e existe um filtro aplicado a esse campo.
Preencher datas e valores em falta
filters: ` is not supported for measures of non-aggregate type '(?)' IDE Ex Foi usado um parâmetro filters com qualquer tipo de medida que não seja o seguinte: count, sum, average e count_distinct.
Unknown source explore (?) in lookml test (?) declaration. IDE
  • É usado um nome do comando Explore com erro ortográfico, inexistente ou com comentário no subparâmetro explore_source de um teste de dados.
  • Um teste de dados é definido num ficheiro que não inclui ou não está incluído no ficheiro que contém a definição de explore_source do Explorar.
  • Uma exploração com a especificação do parâmetro extension: required é usada como o explore_source de um teste de dados.
filter_expression: is not supported for measures of non-aggregate type '(?)' IDE Ex Foi usado um parâmetro filters_expression com qualquer tipo de medida que não seja um dos seguintes: count, sum, average ou count_distinct.
Field references an aggregate but is specified as a dimension. If you want to use aggregations such as sum, average, count, use a measure type instead. IDE Ex Uma dimensão faz referência a uma medida ou a outra agregação no respetivo parâmetro sql
Cannot specify both sql_table_name and derived_table for view (?) IDE Uma visualização tem os parâmetros sql_table_name e derived_table definidos. Uma vista só pode fazer referência a uma tabela: um esquema existente na ligação à base de dados com sql_table_name ou uma nova tabela com derived_table.
Persistent Native Derived Table for view (?) has an explore source (?) that has access filters. Persisting this table may result in unexpected behavior. IDE Uma NDT persistente baseia-se numa análise detalhada com um parâmetro access_filter que faz referência aos atributos do utilizador.
Unknown or unexpected parameter "(?)" in (?). IDE
  • É usado um parâmetro distribution_style para um dialeto que não suporta esse parâmetro
  • É usado um parâmetro cluster_keys para um dialeto que não suporta esse parâmetro
  • Um parâmetro sql_always_where é definido num join em vez de num explore.
  • Os intervalos de tempo definidos num dimension_group não são do tipo type: time.
  • Um parâmetro sql_distinct_key está definido numa dimensão em vez de numa medida.
Could not find the constant IDE Uma constante é referenciada a partir de um projeto importado num projeto de importação e só é definida no projeto importado. Só é possível fazer referência a constantes nos projetos em que estão definidas. A constante tem de ser redefinida no ficheiro de manifesto. Usar constantes em ficheiros de um projeto importado
Multiple primary key definitions for view '(?)': '(?)' and '(?)' IDE Existe mais do que uma chave principal num ficheiro de visualização. Foi especificada mais do que uma dimensão como chave principal com primary_key: yes, ou uma vista de extensão especifica uma nova dimensão como chave principal com primary_key: yes.
Persistent Native Derived Table for view (?) references user attributes. Persisting this table may result in unexpected behavior. IDE Um NDT persistente ou uma tabela de reconhecimento agregada baseia-se num explore com um parâmetro access_filter ou sql_always_where que faz referência aos atributos do utilizador.
No map layer named (?) is defined. Must be one of countries, uk_postcode_areas, us_counties_fips, us_states, us_zipcode_tabulation_areas IDE Uma dimensão faz referência a uma camada de mapa com map_layer_name quando não existe nenhuma camada de mapa definida em todos os modelos nos quais a vista do campo está incluída. Por exemplo, uma vista está incluída em vários modelos, mas a camada de mapa está definida apenas num modelo.
Persistent derived table (?) should include at least one index IDE Uma PDT ou uma definição de tabela agregada inclui um index no qual não foi especificada uma coluna de PDT ou de tabela agregada.
The x database encountered an error while running this query. Ex SQL A base de dados não consegue localizar uma coluna referenciada pelo parâmetro de um campo.sql Isto pode dever-se a uma das seguintes condições:
  • Existe um erro ortográfico no nome da tabela ou da coluna referenciado num parâmetro sql.
  • Os dados subjacentes na base de dados, por exemplo, o nome de uma coluna, foram alterados.
Dicas comuns de resolução de problemas de erros de SQL no Looker (publicação da comunidade)
Render job (?) failed [orphaned job] S A instância do Looker estava indisponível durante a execução da tarefa agendada. Isto pode acontecer durante as atualizações de versões e a manutenção programada. Política de manutenção da Google para serviços alojados no Looker