Erro: campo desconhecido ou inacessível

Quando você estiver trabalhando nos arquivos do LookML e estiver satisfeito com as atualizações, a próxima etapa para implantar as mudanças do LookML é executar o Validador do LookML para realizar uma validação completa do modelo.

Às vezes, você pode encontrar um erro como este:

 Unknown or inaccessible field "user_order_facts.lifetime_orders" referenced in "users.lifetime_orders". Check for typos and missing joins.

Neste exemplo, o erro se refere ao campo lifetime_orders na visualização users. O erro indica que users.lifetime_orders não pode acessar o campo user_order_facts.lifetime_orders que ele referencia.

Por que esse erro ocorre?

Esse erro pode ocorrer por alguns motivos:

1. O campo mencionado não existe.
2. O campo que você está referenciando é um grupo de dimensão inteiro. Por exemplo, um grupo de dimensão é referenciado sem um timeframe anexado.
3. O campo não pode ser acessado por algumas Análises porque não há uma mesclagem.

Opção 1: o campo não existe

Se o campo user_order_facts.lifetime_orders for referenciado nos campos do LookML, mas não existir como um campo, você vai receber o erro unknown or inaccessible field.

Para resolver o problema, adicione o campo que está causando o erro (neste exemplo, user_order_facts.lifetime_orders) à visualização que contém o campo em questão. Nesse caso, verifique se o campo está definido na visualização user_order_facts. você pode adicioná-lo, caso ainda não exista.

Opção 2: o campo faz referência a um grupo de dimensões inteiro

Os grupos de dimensões representam um grupo de dimensões. Os grupos de dimensão type: time representam um grupo de dimensões de período de tempo definidas no parâmetro timeframe. Ao fazer referência a grupos de dimensões no LookML, é necessário anexar a dimensão adequada (timeframe, neste caso) ao nome do grupo de dimensões.

Por exemplo, considere o seguinte grupo de dimensões:

  dimension_group: created {
    type: time
    timeframes: [date, week, month]
    sql: ${TABLE}.created_at ;;
  }

Se você quiser fazer referência ao grupo de dimensão created em outro campo do LookML, faça referência a uma dimensão período específica no grupo, como uma das seguintes:

• date: ${created_date}
• week: ${created_week}
• month: ${created_month}

Se você tentar usar apenas o nome do grupo de dimensão (${created}), o Looker não vai saber a que período você está se referindo e vai gerar o erro.

Opção 3: falta uma mesclagem

Confira a seguir a definição do LookML de users.lifetime_orders:

  dimension: lifetime_orders {
    type: number
    sql: ${user_order_facts.lifetime_orders};;
  }

Observe o uso da função operadores de substituição ${} para fazer referência ao campo user_order_facts.lifetime_orders do LookML.

A dimensão lifetime_orders na visualização users faz referência ao campo lifetime_orders na visualização user_order_facts. Nesse caso, o erro é acionado porque há instâncias no arquivo de modelo em que a visualização users é mesclada a uma Análise detalhada sem a user_order_facts também ter sido mesclada.

Para saber quais análises estão causando o problema, abra as ocorrências destacadas na mensagem de erro:

Essas ocorrências mostram que as Análises order_items e orders no modelo ecommerce estão causando o erro. Essas análises detalhadas têm muitas juntas e são definidas da seguinte forma no arquivo de modelo:

  explore: orders {
    join: users { # users joined without user_order_facts
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
  }

  explore: order_items {
    join: inventory_items {
      relationship: many_to_one
      sql_on: ${order_items.inventory_item_id} = ${inventory_items.id}
    }
    join: orders {
      relationship: many_to_one
      sql_on: ${order_items.order_id} = ${orders.id}
    }
    join: users { # users joined without user_order_facts
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
  }

Em ambas as análises detalhadas, a visualização users é mesclada sem mesclar a visualização user_order_facts. Portanto, nenhuma das análises detalhadas pode acessar o campo user_order_facts.lifetime_orders. Se você tentar consultar o campo users.lifetime_orders, que faz referência a user_order_facts.lifetime_orders, em qualquer uma das opções "Explorar", o erro será acionado.

O validador do LookML está alertando que os usuários vão receber o erro ao consultar users_order_facts.lifetime_orders. O campo users.lifetime_orders não vai acionar o erro em uma Análise à qual o user_order_facts também faz parte.

Por exemplo, considere a análise users:

  explore: users {
    join: user_order_facts {
      sql_on: ${users.id} = ${user_order_facts.users_id}
    }
  }

Aqui, user_order_facts é mesclada, portanto, consultar users.lifetime_orders não vai gerar um erro.

Como posso corrigir o erro quando ele é causado por uma mesclagem ausente?

Se o erro for causado por uma mesclagem ausente, há duas maneiras de corrigir esse erro:

1. Junte as visualizações ausentes em todos os casos. No exemplo usado nesta página, verifique se a visualização user_order_facts é mesclada sempre que a visualização users é mesclada em uma Análise.
2. Exclua o campo que está causando o erro das análises se você não quiser mesclar a visualização ausente.

Participar da visualização ausente

No exemplo anterior, o erro pode ser resolvido combinando user_order_facts com todas as Análises detalhadas em que users também é combinado. Isso garante que as análises possam acessar user_order_facts.lifetime_orders quando users.lifetime_orders for usado em uma consulta.

Use o painel de metadados no ambiente de desenvolvimento integrado para conferir todas as análises que usam a visualização users.

  explore: order_items {
    join: inventory_items {
      relationship: many_to_one
      sql_on: ${inventory_items.id} = ${order_items.inventory_item_id}
    }
    join: orders {
      relationship: many_to_one
      sql_on: ${order_items.order_id} = ${orders.id}
    }
    join: users {
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
    join: user_order_facts { # join user_order_facts through users
      relationship: many_to_one
      sql_on: ${users.id} = ${user_order_facts.users_id}
    }
  }

Talvez você não queira mesclar a visualização user_order_facts a todas as análises em que users é mesclada. Por exemplo, talvez você não queira que os usuários acessem os campos da visualização user_order_facts na Análise orders, mas quer que eles acessem os campos da visualização users sem erros. Para isso, exclua o campo que está causando o erro: users.lifetime_orders — da Análise orders, usando o fields.

Com o parâmetro fields, é possível incluir ou excluir campos específicos de uma Análise. Nesse caso, é possível excluir users.lifetime_orders da análise detalhada orders desta forma:

  explore: orders {
    fields: [ALL_FIELDS*, -users.lifetime_orders] # exclude users.lifetime_orders
    join: users {
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
  }