Misure di periodo in periodo in Looker

L'analisi periodo-su-periodo (PoP) è un modello di analisi che misura qualcosa nel presente e lo confronta con la stessa misurazione in un periodo di tempo comparabile nel passato.

Per i dialetti che supportano le misure PoP, gli sviluppatori Looker possono aggiungere misure PoP ai progetti LookML per abilitare l'analisi PoP nei corrispondenti Looker Explores.

Ad esempio, la seguente query Looker Explore mostra il numero di ordini creati nel mese corrente, insieme alle metriche PoP relative al numero di ordini creati l'anno scorso, alla differenza rispetto all'anno scorso e alla variazione percentuale rispetto all'anno scorso. È possibile verificare il confronto anno su anno controllando a campione i valori. Ad esempio, il valore per Ordini dell'anno scorso per 2012-03 è lo stesso del valore per Numero di ordini per 2011-03:

Looker Explore mostra che gli ordini dell'anno scorso, relativi al periodo marzo 2012, sono stati 89, e che anche il numero di ordini per il periodo marzo 2011 è pari a 89.

Per aggiungere una misura PoP a un progetto LookML, uno sviluppatore Looker deve creare un measure di type: period_over_period e includere i sottoparametri descritti nella sezione seguente di questa pagina.

Ad esempio, ecco il LookML per una misura PoP che fornisce il numero di ordini per l'anno precedente:

  measure: order_count_last_year {
    type: period_over_period
    description: "Order count from the previous year"
    based_on: orders.count
    based_on_time: orders.created_year
    period: year
    kind: previous
  }

Questa misura PoP presenta i seguenti attributi:

  • È definito con based_on: orders.count, quindi la misura PoP fornirà dati sul numero di ordini del periodo precedente.
  • È definito come kind: previous, il che significa che fornisce il valore del conteggio del periodo di tempo precedente (a differenza della differenza nel numero di ordini rispetto al periodo di tempo precedente, o della percentuale di variazione del numero di ordini rispetto al periodo di tempo precedente).
  • È definito con period: year, quindi fornirà il numero di ordini relativi a un periodo di tempo comparabile rispetto all'anno precedente.

Sottoparametri delle misure PoP

Una misura PoP è un measure di type: period_over_period che include i sottoparametri descritti nelle sezioni seguenti:

Come descritto nella sezione Query di esplorazione con misure PoP, le misure PoP calcolano i loro valori in base sia alla definizione LookML della misura PoP sia ai campi in una query di esplorazione. Per questo motivo, è consigliabile attenersi alle seguenti best practice quando si crea una misura PoP in LookML:

  • Fornisci agli utenti di Explore un'indicazione del periodo della misura PoP, sia nel nome della misura PoP sia nel sottoparametro description della misura.
  • Fornisci ai tuoi utenti Explore un'indicazione della misura based_on della misura PoP, sia nel nome della misura PoP sia nel sottoparametro description della misura.

Ad esempio, la seguente misura PoP si chiama order_count_last_year ed è accompagnata da una descrizione che informa gli utenti che la misura fornisce il numero di ordini dell'anno precedente:

  measure: order_count_last_year {
    type: period_over_period
    description: "Order count from the previous year"
    based_on: orders.count
    based_on_time: orders.created_year
    period: year
    kind: previous
  }

based_on

Utilizzare il campo based_on per specificare la misura LookML su cui si basa la misura PoP. Ad esempio, per basare una misura PoP sul campo orders.count, si dovrebbe inserire quanto segue:

    based_on: orders.count

Una misura PoP basata su orders.count fornirà informazioni sul numero di ordini di un periodo precedente, in modo da poter confrontare il numero di vendite tra un periodo corrente e un periodo precedente.

La misura LookML che specifichi nel campo based on deve essere di uno dei seguenti tipi:

based_on_time

Utilizzare il sottoparametro based_on_time per fornire a Looker un campo temporale che può utilizzare per calcolare i valori della misura PoP. Questo campo temporale può essere uno dei seguenti:

  • Una dimensione basata sul tempo. Se si specifica una dimensione basata sul tempo nel sottoparametro based_on_time, gli utenti devono includere esattamente la stessa dimensione basata sul tempo in tutte le query che utilizzano la misura PoP. Inoltre, l'intervallo temporale della dimensione basata sul tempo deve essere uguale o inferiore al valore period della misura PoP. Ad esempio, se la misura PoP è definita con based_on_time: created_month, il valore period della misura PoP non può essere week o date.

  • Uno dei seguenti intervalli di tempo di ungruppo dimensionale ditype: time:

    • year
    • fiscal_year
    • month
    • fiscal_quarter
    • quarter
    • week
    • date
    • raw

  • Uno dei seguenti intervalli di tempo di ungruppo dimensionale ditype: custom_calendar

    • custom_date
    • custom_period
    • custom_quarter
    • custom_season
    • custom_week
    • custom_year

Se si specifica un intervallo temporale del gruppo di dimensioni nel sottoparametro based_on_time, l'intervallo temporale specifico utilizzato è irrilevante: è sufficiente puntare la misura PoP a un gruppo di dimensioni di type: time in modo che la misura PoP possa utilizzare il timestamp sottostante del gruppo di dimensioni. Non è possibile specificare un intervallo di tempo da ungruppo dimensionale ditype: duration I gruppi di dimensioni di tipo durata non sono supportati e genereranno un errore di runtime in Esplora.

kind

Utilizzare il parametro kind per specificare il tipo di calcolo che si desidera che la misura PoP esegua per il periodo precedente. È possibile specificare uno dei seguenti valori per kind:

  • previous: (predefinito) Il valore del periodo precedente.
  • difference: La differenza tra i periodi (il periodo precedente sottratto al periodo corrente).

  • relative_change: La variazione percentuale rispetto al periodo precedente. La variazione percentuale viene calcolata mediante la seguente equazione:

    $$ relativeChange = (current - previous)/previous $$

period

Utilizza il sottoparametro period per specificare la cadenza della misura PoP, ovvero quanto indietro vuoi saltare nel tuo confronto. Ad esempio, una misura PoP definita con period: year mostrerà i valori dell'anno precedente. Se esegui una query Esplora sul conteggio mensile degli ordini, la misura period: year PoP mostrerà i valori relativi allo stesso mese dell'anno precedente, in modo da poter confrontare il conteggio degli ordini di novembre 2025 con il conteggio delle vendite di novembre 2024.

Il sottoparametro period supporta i seguenti valori:

  • year
  • fiscal_year
  • quarter
  • fiscal_quarter
  • month
  • week
  • date

custom_calendar_period

Se la tua misura PoP è basata su uncalendario personalizzato (se la misura PoPbased_on_time il parametro specifica un intervallo di tempo di ungruppo dimensionale ditype: custom_calendar ), devi usare ilcustom_calendar_period parametro invece delperiod parametro.

Utilizza il sottoparametro custom_calendar_period per specificare la cadenza della misura PoP, ovvero quanto indietro vuoi saltare nel tuo confronto. Ad esempio, una misura PoP definita con custom_calendar_period: custom_year mostrerà i valori dell'anno precedente (come definito nel calendario personalizzato). Se esegui una query Esplora sul conteggio ordini mensile personalizzato, la misura custom_calendar_period: custom_year PoP mostrerà i valori per lo stesso mese dell'anno precedente, in modo da poter confrontare il conteggio degli ordini per il mese personalizzato nel 2026 con il conteggio delle vendite dello stesso mese personalizzato nel 2025.

Il sottoparametro custom_calendar_period supporta i seguenti valori:

  • custom_date
  • custom_period
  • custom_quarter
  • custom_season
  • custom_week
  • custom_year

Consulta la sezione Utilizzo delle misure PoP con calendari personalizzati per ulteriori informazioni sulla creazione di misure PoP che utilizzano un calendario personalizzato.

value_to_date

Utilizza il sottoparametro value_to_date per indicare se Looker deve calcolare i valori per la misura PoP utilizzando la quantità di tempo trascorso nel periodo di tempo corrente al momento dell'esecuzione della query. Il sottoparametro value_to_date può essere no (impostazione predefinita) o yes.

  • Un valore di no presuppone l'intero periodo di tempo durante l'aggregazione dei dati.
  • Un valore di yes calcolerà la quantità di tempo osservata nel periodo corrente e la applicherà alla misurazione della variazione percentuale.

Ad esempio, con una misura PoP mensile definita con value_to_date: yes, se alle 13:10:00 del 6 giugno esegui una query di esplorazione con la misura PoP e una dimensione dell'intervallo di tempo, Looker applicherà la quantità di tempo trascorsa il 6 giugno (13 ore, 10 minuti e 0 secondi) ai calcoli per ciascuna delle date nella query. Per ogni data, Looker fornirà i valori per le prime 13 ore e 10 minuti.

Se avevi la stessa misura di variazione percentuale definita con value_to_date: no ed eseguivi la stessa query di esplorazione il 6 giugno alle 13:10:00, Looker calcolava il valore della variazione percentuale utilizzando tutti i dati disponibili per ogni data. Se stai cercando di confrontare i valori dal 6 giugno al 6 del mese precedente, tieni presente che, poiché il 6 giugno non è ancora terminato, è possibile che ci siano dati aggiuntivi dopo le 13:10:00.

Consulta Come value_to_date influisce sui valori della misura PoP per un esempio di come value_to_date: yes influisce sui risultati di una query Esplora.

Come descritto nella sezione Requisiti per le query Esplora con misure PoP, quando esegui una query Esplora con una misura PoP, Looker applica automaticamente la granularità del periodo di tempo minima dalla query al periodo di tempo utilizzato dalla misura PoP. Per le query di Esplora con una misura di variazione percentuale definita con value_to_date: yes, Looker prende la dimensione del periodo di tempo più piccolo nella query e calcola la porzione di quel periodo di tempo trascorsa quando viene eseguita la query, quindi applica quella porzione a tutti i valori della misura di variazione percentuale.

Esplora le query con le misure PoP

Il calcolo eseguito per una misura PoP si basa sulla definizione LookML della misura PoP e anche sui periodi di tempo specificati nella query di esplorazione stessa; la misura PoP adatta il suo calcolo ai periodi di tempo selezionati nella query di esplorazione. Ad esempio, se la misura PoP è definita con period: year e la query di Explore contiene la dimensione intervallo di tempo orders.created_month, la misura PoP calcolerà i valori mensili, confrontando gennaio 2025 con gennaio 2024. Se vuoi visualizzare i valori annuali, devi eseguire una query Esplora con la misura PoP e solo l'intervallo di tempo orders.created_year.

Ecco alcuni esempi di come un valore di PoP period interagisce con i periodi di tempo selezionati in una query di esplorazione:

  • Se una misura PoP è definita con period: year ed esegui una query Esplora con un periodo di tempo trimestrale, la misura PoP restituirà i valori dello stesso trimestre dell'anno precedente (T1 2025 rispetto al T1 2024).
  • Se una misura di variazione percentuale è definita con period: year ed esegui una query Esplora con un periodo di un mese, la misura di variazione percentuale restituirà i valori dello stesso mese dell'anno precedente (aprile 2025 rispetto ad aprile 2024).
  • Se una misura PoP è definita con period: month ed esegui una query Esplora con un periodo di tempo di un mese, la misura PoP restituirà i valori del mese precedente (aprile 2025 rispetto a marzo 2025).

Requisiti per esplorare le query con le misure da un periodo all'altro

Poiché una misura PoP esegue i calcoli in base sia alla definizione LookML della misura PoP sia ai campi selezionati nella query Esplora, devi includere almeno i seguenti campi in una query Esplora che ha una misura PoP:

  • La misura PoP.
  • Una dimensione temporale appropriata per period associato alla misura della variazione percentuale. La dimensione temporale può essere inclusa nella query dal selettore campi di Esplora o nei filtri di Esplora:
    • Le query delle misure PoP supportano granularità temporali pari o superiori alla data, come mese, trimestre o anno. Le query delle misure PoP non supportano dimensioni con intervalli di tempo di ore o minuti.
    • Se la misura PoP è definita con un based_on_time che rappresenta un intervallo temporale di un gruppo di dimensioni, la query Esplora deve includere un intervallo temporale dello stesso gruppo di dimensioni che utilizza un intervallo temporale uguale o inferiore a quello specificato nel parametro period della misura PoP. È possibile includere il gruppo di dimensioni direttamente nella finestra Esplora (selezionando il gruppo di dimensioni dal selettore di campi della finestra Esplora) oppure applicando un filtro al gruppo di dimensioni. Ad esempio, se il valore based_on_time della misura PoP è definito con un intervallo temporale del gruppo di dimensioni orders.created e la misura PoP è definita con period: month, la query Esplora deve includere un intervallo temporale del gruppo di dimensioni orders.created che sia uguale o inferiore a un mese, come ad esempio orders.created_date. L'intervallo di tempo nella query Esplora deve essere uguale o inferiore perché, ad esempio, non è possibile effettuare un confronto mese per mese su un intervallo di tempo annuale.
    • Se la misura PoP è definita con una based_on_time che è una dimensione basata sul tempo, allora la query Esplora deve includere esattamente la stessa dimensione basata sul tempo, includendo la dimensione dal selettore di campi di Esplora oppure specificando un filtro sulla dimensione. La dimensione temporale deve essere di intervallo temporale uguale o inferiore a quello specificato nel parametro period della misura PoP. Ad esempio, se la misura PoP è definita con based_on_time: created_date e la misura PoP è definita con period: month, la query Explore deve includere la dimensione created_date.

Se la misura PoP è definita con un based_on_time che rappresenta un intervallo temporale di un gruppo di dimensioni, si prega di notare i seguenti requisiti per l'intervallo temporale nella query Esplora:

  • L'intervallo di tempo nella query Explore deve essere uguale o inferiore a quello specificato nel parametro period della misura PoP. Ad esempio, se la misura PoP based_on_time è definita con un intervallo temporale del gruppo di dimensioni orders.created e la misura PoP è definita con period: month, la query Esplora deve includere un intervallo temporale del gruppo di dimensioni orders.created che sia uguale o inferiore a un mese, come orders.created_date. L'intervallo temporale nella query Esplora deve essere più breve perché, ad esempio, non è possibile effettuare un confronto mese per mese su un intervallo temporale annuale.
  • L'intervallo di tempo nella query Esplora deve contenere a sua volta informazioni di timestamp. Ad esempio, gli intervalli temporali year, month e date di un gruppo di dimensioni forniscono informazioni di timestamp effettive. Al contrario, l'intervallo temporale day_of_week viene astratto dal timestamp sottostante per fornire un valore come Wednesday. Allo stesso modo, intervalli di tempo come month_name, month_num e day_of_month non forniscono informazioni di timestamp, quindi non possono essere utilizzati dalle misure PoP per calcolare i valori per il periodo precedente. Tuttavia, se includi nella query Explore un timestamp come date, questo fornirà alla misura PoP informazioni sul timestamp che potrà utilizzare per calcolare i valori per il periodo precedente. PuoiAnche includere ilday_of_week intervallo di tempo nella query Explore, perché la misura PoP può utilizzare ildate Informazioni relative alle tempistiche per i calcoli.

Fintanto che soddisfi questi requisiti nella tua query Esplora, puoi aggiungere altri campi e dimensioni temporali nella query Esplora, ma tutti gli intervalli temporali nella query Esplora devono essere uguali o inferiori all'intervallo temporale del period della misura PoP. Quando si esegue una query Explore con una misura PoP, Looker applica automaticamente la granularità minima dell'intervallo temporale della query all'intervallo temporale utilizzato dalla misura PoP. Nell'esempio Explore mostrato all'inizio di questa pagina, tutte le misure PoP sono state definite in LookML con period: year. Ciò significa che, indipendentemente dall'intervallo di tempo selezionato nella query Esplora (in questo caso, un intervallo mensile), la misura PoP restituirà i risultati relativi allo stesso intervallo di tempo dell'anno precedente.

Se vuoi vedere quali periodi di tempo sono supportati con la tua misura di variazione percentuale in un'esplorazione, puoi testare periodi di tempo diversi senza dover eseguire query. Fai clic sulla scheda SQL della sezione Dati dell'esplorazione, quindi aggiungi campi e filtri dal selettore di campi dell'esplorazione. Se la misura PoP non riesce a calcolare la query con i campi e i filtri selezionati, la scheda SQL mostrerà un messaggio che indica che non è possibile generare l'SQL.

Se esegui una query per cui non è possibile generare SQL, nella finestra Esplora viene restituito un errore con i dettagli e un link al codice LookML pertinente.

Utilizzo delle misure PoP con calendari personalizzati

Per creare una misura PoP che utilizza un calendario personalizzato, devi:

  • Nel file di visualizzazione in cui modelli il calendario personalizzato, includi facoltativamente un blocco di parametri previous_ordinal_mapping nel blocco di parametri calendar_definition. A partire da Looker 26.8, il parametro previous_ordinal_mapping è facoltativo. In Looker 26.8 e versioni successive, per i calendari personalizzati Looker presuppone che la settimana precedente alla settimana 1 sia la settimana 52 e che il giorno precedente al giorno 1 sia il giorno 364. Se non è così per il tuo calendario personalizzato, devi utilizzare il blocco di parametri previous_ordinal_mapping.
  • Nella definizione LookML della misura PoP, nel parametro based_on_time, specifica l'intervallo di tempo annuale di un gruppo di dimensioni di type: custom_calendar
  • Nella definizione LookML della misura PoP, utilizza il parametro custom_calendar_period anziché il parametro period.

Ad esempio, ecco il codice LookML per un gruppo di dimensioni del calendario personalizzato e una misura PoP che utilizza il calendario personalizzato:

dimension_group: cust_created {
    type: custom_calendar
    sql: {TABLE}.created_at;;
    based_on_calendar: cust_retail_calendar
    custom_timeframes: [custom_year, custom_quarter]

  }

measure: count_last_custom_year {
    type: period_over_period
    based_on: count
    based_on_time: cust_created_custom_year
    custom_calendar_period: custom_year
    kind: previous
  }

Esempi

Le sezioni seguenti mostrano alcuni esempi di diverse misure di PoP e query di esplorazione:

Confronto dei conteggi con le misurazioni PoP su base annua e mensile

Di seguito è riportato il codice LookML per una misura total_births di esempio, un gruppo di dimensioni birth di type:time e due misure PoP basate sulla misura total_births e che utilizzano il gruppo di dimensioni birth come campo based_on_time:


  dimension_group: birth {
    type: time
    timeframes: [raw, time, date, week, month, quarter, year]
    sql: ${TABLE}.birth_date ;;
  }

  measure: total_births {
    type: sum
    sql: ${TABLE}.total_births ;;
  }

  measure: total_births_last_year {
    type: period_over_period
    kind: previous
    based_on: total_births
    based_on_time: birth_year
    period: year
    value_to_date: no
    value_format_name: decimal_0
  }

  measure: total_births_last_month {
    type: period_over_period
    kind: previous
    based_on: total_births
    based_on_time: birth_year
    period: month
    value_to_date: no
    value_format_name: decimal_0
  }

Tieni presente quanto segue in merito a questi campi:

  • Entrambe le misure di variazione percentuale sono definite con kind: previous, quindi forniscono il valore della misura del periodo precedente.
  • Entrambe le misure PoP sono definite con value_to_date: no, quindi calcolano il valore della misura per l'intero periodo di tempo (ovvero la granularità minima del periodo di tempo della query).
  • Entrambe le misure PoP sono definite con based_on_time: birth_year, quindi utilizzano il timestamp sottostante del gruppo di dimensioni birth.
  • La misurazione del PoP total_births_last_year è definita con period: year e la misurazione del PoP total_births_last_month è definita con period: month.

Ecco una query di esplorazione che include tutte e tre le misure e il periodo di tempo della dimensione birth_month:

Esplorazione di Looker che mostra le colonne Mese di nascita, Nati totali, Nati totali mese scorso, Nati totali anno scorso. Il valore Nati totali mese scorso per il periodo 2024-07 è 290.699, che corrisponde al valore Nati totali per il periodo 2024-06. Il valore Nati totali anno precedente per il mese di luglio 2024 è 310.347, che corrisponde al valore Nati totali per il mese di luglio 2023.

Tieni presente quanto segue in merito ai risultati di Esplora:

  • Il periodo di tempo più breve della dimensione nella query di esplorazione è birth_month, quindi la misura PoP fornisce valori mensili.
  • Nella riga relativa al mese più recente, 2024-07, il valore Total Births Last Month (Nati totali il mese scorso) mostra il totale delle nascite del mese precedente, ovvero giugno 2024. Puoi verificarlo esaminando il valore Nati totali per la riga 2024-06. I due valori corrispondono.
  • Nella riga relativa al mese più recente, 2024-07, il valore Total Births Last Year (Nati totali l'anno scorso) mostra il totale delle nascite per lo stesso mese (07) dell'anno precedente (2023). Puoi verificarlo esaminando il valore Total Births (Nascite totali) per la riga 2023-07. I due valori corrispondono.

In che modo value_to_date influisce sui valori della misurazione da un periodo all'altro

Analogamente all'esempio precedente, ecco il codice LookML per la misura total_births e il gruppo di dimensioni birth di type:time e due misure PoP basate sulla misura total_births e che utilizzano il gruppo di dimensioni birth come campo based_on_time. Tuttavia, in questo esempio, la misura PoP total_births_last_year_value_to_date è definita con value_to_date: yes e la misura PoP total_births_last_year è definita con value_to_date: no:

  dimension_group: birth {
    type: time
    timeframes: [raw, time, date, week, month, quarter, year]
    sql: ${TABLE}.birth_date ;;
  }

  measure: total_births {
    type: sum
    sql: ${TABLE}.total_births ;;
  }

  measure: total_births_last_year {
    type: period_over_period
    kind: previous
    based_on: total_births
    based_on_time: birth_year
    period: year
    value_to_date: no
    value_format_name: decimal_0
  }

  measure: total_births_last_year_value_to_date {
    type: period_over_period
    kind: previous
    based_on: total_births
    based_on_time: birth_year
    value_to_date: yes
    period: year
    value_format_name: decimal_0
  }

Ecco una query di Esplora che include tutte e tre le misure e il periodo di tempo della dimensione birth_year. Questa query Esplora è stata eseguita il 4 giugno alle 16:25:08, un dato significativo per la metrica value_to_date: yes PoP.

Looker Explore che mostra le colonne Anno di nascita, Nati totali, Nati totali l'anno scorso, Valore dei nati totali l'anno scorso fino alla data. Il valore Nati totali l'anno scorso per il 2024 è 3.581.036, che corrisponde al valore Nati totali per il 2023. Il valore Nati l'anno scorso fino alla data per il 2024 è 1.743.505.

I risultati di Esplora mostrano in che modo il parametro secondario value_to_date modifica il calcolo per le misure del periodo precedente:

Tieni presente quanto segue in merito ai risultati di Esplora:

  • Nella riga relativa all'anno più recente, 2024, il valore Nati totali l'anno scorso mostra il totale delle nascite dell'anno precedente, il 2023. Puoi verificare il calcolo esaminando il valore Nati totali per la riga 2023. I due valori corrispondono.
  • Nella riga relativa all'anno più recente, 2024, il valore Totale nascite anno precedente fino alla data è inferiore al valore Totale nascite anno precedente. Questo perché la query Esplora è stata eseguita il 4 giugno alle 16:25:08 e perché la misura total_births_last_year_value_to_date PoP è definita con value_to_date: yes, quindi Looker ha calcolato i valori annuali utilizzando solo i dati fino al 4 giugno alle 16:25:08 per ogni anno.

Filtrare le query di Esplora che includono misure di punto di presenza

Tieni presente quanto segue per filtrare le query di Esplora che includono misure di periodo precedente:

  • Il filtro è supportato per le query di Esplora che includono misure PoP. Tuttavia, non puoi filtrare in base a una misura del punto di presenza. Ad esempio, nel primo esempio di esplorazione che esegue query sulla dimensione birth_month e sulle misure PoP total_births, total_births_last_year e total_births_last_month, non è possibile filtrare la query in base alle misure PoP total_births, total_births_last_year o total_births_last_month.
  • Quando filtri un campo associato al parametro based_on_time di una misura PoP, se l'intervallo di tempo del filtro è più preciso di quello della query, la misura PoP mostrerà solo i risultati per la parte del valore del filtro dell'intervallo di tempo della query. Ad esempio, se esegui una query sulla dimensione orders.created_year e la filtri per il mese di gennaio, per ogni anno la metrica PoP mostrerà i valori solo per gennaio. Questi dati possono essere scambiati per i risultati dell'intero anno.
  • Per le query Esplora della misura PoP, per calcolare i dati per la misura PoP, Looker recupera i dati per un periodo di tempo aggiuntivo con la granularità temporale meno granulare della query. Ad esempio, se crei una query Esplora con una dimensione mensile, una misura PoP definita con period: year e un filtro per gli ultimi 6 mesi, Looker identificherà la granularità meno granulare nella query, che in questo esempio sarebbe il periodo di tempo year della misura PoP. In questo esempio, Looker recupera gli ultimi 6 mesi di dati più un anno aggiuntivo di dati in modo da poter confrontare ciascuno degli ultimi 6 mesi con lo stesso mese dell'anno precedente.
  • Come descritto in Requisiti per le query Esplora con misure di variazione percentuale, le query Esplora che includono misure di variazione percentuale devono avere una dimensione temporale appropriata per il period associato alla misura di variazione percentuale. Se non selezioni una dimensione temporale dal selettore campi di Esplora, Looker può ricavare le informazioni richieste dalle dimensioni temporali nei filtri di Esplora. In questo caso, Looker ordinerà i risultati della query di esplorazione in base alla dimensione temporale del filtro.

Visualizzazioni con misure da un periodo all'altro

La visualizzazione grafico a tabella è consigliata per le misure PoP. Anche altre opzioni di visualizzazione potrebbero funzionare, a seconda dei campi della query di Explore.

Se si utilizza una visualizzazione diversa da una tabella, verificare che sia chiara. Poiché le misure PoP forniscono confronti con un periodo di tempo precedente, le visualizzazioni che utilizzano tali misure possono essere fuorvianti. Ad esempio, una misura PoP anno su anno definita come kind: previous mostrerà il valore dell'anno scorso per la data di quest'anno. Se la query di Esplora include il valore dell'anno corrente insieme alla misura PoP anno su anno, l'anno corrente avrà due valori nella visualizzazione.

Se si utilizza una visualizzazione diversa da una tabella, verificare che essa indichi chiaramente che le misure PoP si riferiscono a un confronto con un periodo di tempo precedente.

Limitazioni per le misure PoP

Si prega di notare le seguenti limitazioni delle misure PoP:

  • Le misure PoP sono supportate solo per i progetti LookML che utilizzano il nuovo runtime LookML. Se ilUtilizzare il runtime LookML legacy La funzionalità legacy è abilitata sulla tua istanza, file manifesto per il tuo progetto deve includere unnew_lookml_runtime:yes dichiarazione.
  • Le misure PoP non sono supportate con il connettore Looker in Data Studio.
  • Le misure PoP devono essere basate su una misura aggregata, come descritto nelbased_on sezione. Non è possibile basare una misura PoP su una misura non aggregata.
  • Per le connessioni BigQuery su istanze in cui è abilitata la funzionalità BI Engine Symmetric Aggregates Labs, le misure PoP sono supportate, ma le query SQL con misure PoP non utilizzeranno la funzionalità BI Engine Symmetric Aggregates.
  • Le misure PoP non sono adatte all'analisi di coorte.
  • Le misure PoP non supportano i calcoli progressivi.
  • Le misurazioni PoP confrontano sempre il periodo corrente con il periodo precedente. Non è possibile configurare una misura PoP per confrontare il periodo corrente con un periodo diverso da quello precedente. Ad esempio, non è possibile creare una misura PoP per confrontare maggio dello scorso anno con dicembre di quest'anno.
  • Le misurazioni PoP non sono supportate da intervalli arbitrari, come ad esempio le ultime due settimane rispetto alle due settimane precedenti.
  • I parametri liquidi non sono supportati nei parametri di una misura PoP. Tuttavia, se i campi based_on o based_on_time di una misura PoP puntano a una dimensione definita con Liquid, tale Liquid verrà elaborato.

  • Per le misure PoP che utilizzano calendari personalizzati:

    • (Prima di Looker 26.8) Ilbased_on_time il parametro deve fare riferimento acustom_year periodo di tempo di ungruppo dimensionale ditype: custom_calendar.
    • (Prima di Looker 26.8) Per le misure PoP definite con custom_calendar_period: custom_year, se la query dell'utente contiene custom_week o custom_date, Looker fornirà il valore per la settimana precedente o la data dell'anno precedente.

  • Le misure PoP non sono supportate con le seguenti funzionalità di Looker:

  • Le misure PoP non possono essere utilizzate per creare un campo personalizzato.

  • Per i confronti basati sulla settimana, ti consigliamo di creare una misura PoP che utilizzi un calendario personalizzato.

  • Le misure PoP con periodi definiti in base a intervalli temporali fiscali non possono essere utilizzate nelle query Explore con intervalli temporali non fiscali. Inoltre, le misure PoP con periodi definiti con intervalli temporali non fiscali non possono essere utilizzate in query con dimensioni temporali fiscali.

  • Le misure del periodo di promozione supportano l'offset del mese fiscale, in quanto il parametro based_on_time della misura del periodo di promozione erediterà il valore fiscal_month_offset dal file del modello LookML associato all'esplorazione. Se definisci una misura PoP con fiscal_year o fiscal_quarter, la misura PoP sarà supportata in una query Esplora solo se la query Esplora specifica un periodo di tempo fiscal_year o fiscal_quarter. In tal caso, lo fiscal_offset_month viene rispettato.

  • Il period della metrica PoP deve essere uguale o maggiore del periodo di tempo selezionato nella query Esplora. Ad esempio, per una misura PoP definita con period: month, la query Explore deve avere una dimensione temporale di un mese o inferiore, come una settimana o un giorno.

  • Quando si utilizzano le misure PoP, includere sempre la dimensione temporale corrispondente in Esplora insieme alla dimensione date_time. Ad esempio, se definisci una misura PoP per calcolare i valori per il mese corrispondente del trimestre precedente, devi includere la dimensione del trimestre corrispondente (ad esempio [dimension_name]_quarter) in Esplora insieme alla dimensione del mese. Senza la dimensione Intervallo di tempo corrispondente, l'SQL generato applica una funzione di troncamento (ad esempio TIMESTAMP_TRUNC(..., QUARTER)) alla data prima di calcolare il periodo precedente, facendo in modo che la query venga valutata in base all'inizio del trimestre.

    Ad esempio, in un confronto per febbraio, l'SQL generato recupererebbe il valore per il primo mese del trimestre precedente (ottobre) anziché per il mese corrispondente (novembre). L'inclusione della dimensione Intervallo di tempo corrispondente nell'esplorazione garantisce la corretta generazione e il corretto raggruppamento di SQL.

Dialetti del database supportati per le metriche Point of Presence

La tabella seguente mostra quali dialetti supportano le misure PoP nell'ultima versione di Looker:

Dialetto Supportata?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud AlloyDB for PostgreSQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MongoSQL
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica