Errore: campo sconosciuto o inaccessibile

Quando lavori sui file LookML e sei soddisfatto degli aggiornamenti, il passaggio successivo per eseguire il deployment delle modifiche a LookML è eseguire il validatore LookML per eseguire una convalida completa del modello.

A volte potresti visualizzare un errore simile al seguente:

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

In questo esempio, l'errore si riferisce al campo lifetime_orders nella visualizzazione users. L'errore indica che users.lifetime_orders non può accedere al campo user_order_facts.lifetime_orders a cui fa riferimento.

Albero di debug

Utilizza il seguente albero decisionale per risolvere i problemi comuni di Liquid:

Le sezioni seguenti descrivono in modo più dettagliato gli scenari dell'albero.

Perché si verifica questo errore?

Questo errore può verificarsi per alcuni motivi:

1. Il campo a cui fai riferimento non esiste.
2. Il campo a cui fai riferimento è un intero gruppo di dimensioni, ad esempio un gruppo di dimensioni a cui si fa riferimento senza un elemento aggiuntotimeframe.
3. Il campo non è accessibile da alcune esplorazioni perché manca un join.

Il campo non esiste

Se si fa riferimento al campo user_order_facts.lifetime_orders nei campi LookML, ma non esiste come campo stesso, riceverai l'errore unknown or inaccessible field.

Puoi risolvere l'errore aggiungendo il campo che lo attiva, in questo esempio user_order_facts.lifetime_orders, alla visualizzazione che contiene il campo in questione. In questo caso, puoi assicurarti che il campo sia definito nella visualizzazione user_order_facts. Se non esiste, puoi aggiungerlo.

Il campo fa riferimento a un intero gruppo di dimensioni

I gruppi di dimensioni rappresentano un gruppo di dimensioni. type: time i gruppi di dimensioni rappresentano un gruppo di dimensioni del periodo di tempo definite nel parametro timeframe. Quando fai riferimento ai gruppi di dimensioni in LookML, devi aggiungere la dimensione appropriata, in questo caso timeframe, al nome del gruppo di dimensioni.

Ad esempio, considera il seguente gruppo di dimensioni:

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

Se vuoi fare riferimento al gruppo di dimensioni created in un altro campo LookML, devi fare riferimento a una dimensione timeframe specifica all'interno del gruppo, ad esempio una delle seguenti:

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

Se provi a utilizzare solo il nome del gruppo di dimensioni, ${created}, Looker non saprà a quale periodo di tempo fai riferimento e genererà l'errore.

Manca un join

Di seguito è riportata la definizione LookML di users.lifetime_orders:

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

Tieni presente l'utilizzo degli operatori di sostituzione ${} per fare riferimento al campo LookML user_order_facts.lifetime_orders.

La dimensione lifetime_orders nella visualizzazione users fa riferimento al campo lifetime_orders della visualizzazione user_order_facts. In questo caso, l'errore viene attivato perché nel file del modello sono presenti istanze in cui la visualizzazione users viene unita a un'esplorazione senza che sia stata unita anche user_order_facts.

Per vedere quali esplorazioni causano il problema, puoi espandere le occorrenze evidenziate nel messaggio di errore:

Queste occorrenze mostrano che le esplorazioni order_items e orders nel modello ecommerce causano l'errore. Queste esplorazioni hanno molti join e sono definite come segue nel file del modello:

  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}
    }
  }

In entrambe queste esplorazioni, la visualizzazione users viene unita senza unire anche la visualizzazione user_order_facts. Di conseguenza, nessuna delle due esplorazioni può accedere al campo user_order_facts.lifetime_orders. Se provassi a eseguire una query sul campo users.lifetime_orders, che fa riferimento a user_order_facts.lifetime_orders, in una delle due esplorazioni, attiveresti l'errore.

Il validatore LookML ti avvisa che gli utenti riceveranno l'errore quando eseguono una query su users_order_facts.lifetime_orders. Il campo users.lifetime_orders non attiverà l'errore in un'esplorazione a cui è unito anche user_order_facts.

Ad esempio, considera l'esplorazione users:

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

Qui user_order_facts è unito, quindi l'esecuzione di una query su users.lifetime_orders non attiverà un errore.

Come posso correggere l'errore quando è causato da un join mancante?

Se l'errore è causato da un join mancante, puoi correggerlo in due modi:

1. Unisci la visualizzazione mancante in tutti i casi. Per l'esempio utilizzato in questa pagina, assicurati che la visualizzazione user_order_facts sia unita ovunque la visualizzazione users sia unita in un'esplorazione.
2. Escludi il campo che causa l'errore dalle esplorazioni se non vuoi unire la visualizzazione mancante.

Unisci la visualizzazione mancante

Nell'esempio precedente, l'errore può essere risolto unendo user_order_facts a tutte le esplorazioni in cui è unito anche users. In questo modo, le esplorazioni potranno accedere a user_order_facts.lifetime_orders quando users.lifetime_orders viene utilizzato in una query.

Puoi utilizzare il riquadro dei metadati nell'IDE per visualizzare tutte le esplorazioni che utilizzano la visualizzazione users.

L'esempio seguente unisce le visualizzazioni mancanti:

  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}
    }
  }

Ora, se esegui di nuovo il validatore LookML, questo errore non dovrebbe essere visualizzato.

Escludi il campo che causa l'errore dalle esplorazioni

Potresti non voler unire la visualizzazione user_order_facts a tutte le esplorazioni in cui è unito users. Ad esempio, potresti non voler consentire agli utenti di accedere ai campi della visualizzazione user_order_facts nell'esplorazione orders, ma vuoi che gli utenti accedano ai campi della visualizzazione users senza errori. Puoi farlo escludendo il campo che causa l'errore — users.lifetime_orders — dall'esplorazione orders utilizzando il fields parametro.

Il parametro fields per le esplorazioni consente di includere o escludere campi specifici da un'esplorazione. In questo caso, puoi escludere il campo users.lifetime_orders dall'esplorazione orders nel seguente modo:

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