PivotTable
Una tabella pivot.
Rappresentazione JSON |
---|
{ "rows": [ { object ( |
Campi | |
---|---|
rows[]
|
Ogni raggruppamento di righe nella tabella pivot. |
columns[]
|
Ogni raggruppamento di colonne nella tabella pivot. |
criteria
|
Una mappatura facoltativa dei filtri per l'offset della colonna di origine. I filtri vengono applicati prima dell'aggregazione dei dati nella tabella pivot. La chiave della mappa è l'offset della colonna dell'intervallo di origine da filtrare e il valore è i criteri per quella colonna.
Ad esempio, se l'origine era
Questo campo è deprecato in favore di
|
filterSpecs[]
|
I filtri applicati alle colonne di origine prima dell'aggregazione dei dati per la tabella pivot.
Sia
|
values[]
|
Un elenco di valori da includere nella tabella pivot. |
valueLayout
|
Indica se i valori devono essere elencati orizzontalmente (come colonne) o verticalmente (come righe). |
dataExecutionStatus
|
Solo output. Lo stato di esecuzione dei dati per le tabelle pivot dell'origine dati. |
Campo unione
source_data . L'origine dei dati della tabella pivot.
source_data
può essere solo uno dei seguenti:
|
|
source
|
L'intervallo da cui la tabella pivot legge i dati. |
dataSourceId
|
L'ID dell'origine dati da cui la tabella pivot legge i dati. |
PivotGroup
Un singolo raggruppamento (riga o colonna) in una tabella pivot.
Rappresentazione JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Campi | |
---|---|
showTotals
|
True se la tabella pivot deve includere i totali per questo raggruppamento. |
valueMetadata[]
|
Metadati sui valori nel raggruppamento. |
sortOrder
|
L'ordine in cui devono essere ordinati i valori in questo gruppo. |
valueBucket
|
Il bucket del gruppo pivot opposto in base al quale ordinare. Se non specificato, l'ordinamento è alfabetico in base ai valori di questo gruppo. |
repeatHeadings
|
True se le intestazioni in questo gruppo pivot devono essere ripetute. Questo valore è valido solo per i raggruppamenti di righe e viene ignorato dalle colonne. Per impostazione predefinita, riduciamo al minimo la ripetizione delle intestazioni non mostrando quelle di livello superiore se sono uguali. Ad esempio, anche se la terza riga di seguito corrisponde a "1° trimestre mar", "1° trimestre" non viene visualizzata perché è ridondante con le righe precedenti. Se imposti repeatHeadings su true, "T1" verrà ripetuto per "Feb" e "Mar".
|
label
|
Le etichette da utilizzare per i gruppi di righe/colonne che possono essere personalizzati. Ad esempio, nella seguente tabella pivot, l'etichetta riga è
|
groupRule
|
La regola del gruppo da applicare a questo gruppo di righe/colonne. |
groupLimit
|
Il limite di conteggio per righe o colonne da applicare a questo gruppo pivot. |
Campo unione
source . L'origine dati del gruppo pivot.
source
può essere solo uno dei seguenti:
|
|
sourceColumnOffset
|
Lo spostamento di colonna dell'intervallo di origine su cui si basa questo raggruppamento.
Ad esempio, se la sorgente era
|
dataSourceColumnReference
|
Il riferimento alla colonna dell'origine dati su cui si basa questo raggruppamento. |
PivotGroupValueMetadata
Metadati relativi a un valore in un raggruppamento pivot.
Rappresentazione JSON |
---|
{
"value": {
object ( |
Campi | |
---|---|
value
|
Il valore calcolato a cui corrispondono i metadati. Tieni presente che
|
collapsed
|
True se i dati corrispondenti al valore sono compressi. |
PivotGroupSortValueBucket
Informazioni sui valori in un gruppo pivot da utilizzare per l'ordinamento.
Rappresentazione JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
Campi | |
---|---|
valuesIndex
|
L'offset nell'elenco
|
buckets[]
|
Determina il bucket da cui vengono scelti i valori da ordinare. Ad esempio, in una tabella pivot con un gruppo di righe e due gruppi di colonne, il gruppo di righe può elencare fino a due valori. Il primo valore corrisponde a un valore all'interno del primo gruppo di colonne e il secondo a un valore nel secondo gruppo di colonne. Se non sono elencati valori, significa che la riga deve essere ordinata in base al "Totale generale" nei gruppi di colonne. Se è elencato un singolo valore, corrisponde all'utilizzo di "Totale" del bucket in questione. |
PivotGroupRule
Un'impostazione facoltativa su un
PivotGroup
che definisce i bucket per i valori nella colonna dei dati di origine anziché suddividere ogni singolo valore. Per ogni colonna dei dati di origine è possibile aggiungere un solo
PivotGroup
con una regola di gruppo, anche se in una determinata colonna puoi aggiungere sia un
PivotGroup
con una regola sia un
PivotGroup
senza regole.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
rule . La regola da applicare al
PivotGroup .
rule
può essere solo uno dei seguenti:
|
|
manualRule
|
A
|
histogramRule
|
|
dateTimeRule
|
A
|
ManualRule
Ti consente di organizzare manualmente i valori in una colonna di dati di origine in bucket con nomi a tua scelta. Ad esempio, una tabella pivot che aggrega la popolazione per stato:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
può essere trasformata in una tabella pivot che aggrega la popolazione per fuso orario fornendo un elenco di gruppi (ad es. groupName = "Central", items = ["AL", "AR", "IA", ...]) a una regola di gruppo manuale. Tieni presente che un effetto simile può essere ottenuto aggiungendo una colonna del fuso orario ai dati di origine e modificando la tabella pivot.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
Rappresentazione JSON |
---|
{
"groups": [
{
object ( |
Campi | |
---|---|
groups[]
|
L'elenco dei nomi dei gruppi e gli elementi corrispondenti dei dati di origine che mappano a ciascun nome di gruppo. |
ManualRuleGroup
Un nome di gruppo e un elenco di elementi dei dati di origine da inserire nel gruppo con questo nome.
Rappresentazione JSON |
---|
{ "groupName": { object ( |
Campi | |
---|---|
groupName
|
Il nome del gruppo, che deve essere una stringa. Ogni gruppo in un determinato
|
items[]
|
Gli elementi nei dati di origine che devono essere inseriti in questo gruppo. Ogni elemento può essere una stringa, un numero o un valore booleano. Gli elementi possono essere visualizzati in un massimo di un gruppo all'interno di un determinato
|
HistogramRule
Consente di organizzare i valori numerici in una colonna di dati di origine in bucket di dimensioni costanti. Tutti i valori da
HistogramRule.start
a
HistogramRule.end
vengono inseriti in gruppi di dimensione
HistogramRule.interval
. Inoltre, tutti i valori inferiori
HistogramRule.start
vengono inseriti in un gruppo e tutti i valori superiori
HistogramRule.start
in un altro.HistogramRule.end
È obbligatorio solo HistogramRule.interval
, anche se se vengono forniti sia HistogramRule.start
sia HistogramRule.end
, HistogramRule.start
deve essere inferiore a HistogramRule.end
. Ad esempio, una tabella pivot che mostra l'importo medio degli acquisti per età con più di 50 righe:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
può essere trasformata in una tabella pivot simile a quella riportata di seguito applicando una regola di gruppo di istogrammi con un valore di HistogramRule.start
di 25, un valore di HistogramRule.interval
di 20 e un valore di HistogramRule.end
di 65.
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
Rappresentazione JSON |
---|
{ "interval": number, "start": number, "end": number } |
Campi | |
---|---|
interval
|
Le dimensioni dei bucket creati. Il valore deve essere positivo. |
start
|
Il valore minimo a cui gli elementi vengono inseriti in bucket di dimensioni costanti. I valori inferiori a start vengono raggruppati in un unico bucket. Questo campo è facoltativo. |
end
|
Il valore massimo a cui gli elementi vengono inseriti in bucket di dimensioni costanti. I valori superiori a end vengono raggruppati in un unico bucket. Questo campo è facoltativo. |
DateTimeRule
Consente di organizzare i valori data/ora in una colonna di dati di origine in bucket in base a parti selezionate dei valori data o ora. Ad esempio, prendiamo in considerazione una tabella pivot che mostra le transazioni di vendita per data:
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
L'applicazione di una regola di gruppo data/ora con un
DateTimeRuleType
YEAR_MONTH genera la seguente tabella pivot.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
Rappresentazione JSON |
---|
{
"type": enum ( |
Campi | |
---|---|
type
|
Il tipo di raggruppamento per data e ora da applicare. |
DateTimeRuleType
I tipi di regole di raggruppamento per data e ora disponibili. Questa documentazione presuppone che le impostazioni internazionali del foglio di lavoro siano "en-US", anche se il rendering effettivo delle date e delle ore utilizza le impostazioni internazionali del foglio di lavoro per alcuni tipi di regole.
Enum | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Il tipo predefinito, da non utilizzare. |
SECOND
|
Raggruppa le date per secondo, da 0 a 59. |
MINUTE
|
Raggruppa le date per minuto, da 0 a 59. |
HOUR
|
Raggruppa le date per ora utilizzando un sistema di 24 ore, da 0 a 23. |
HOUR_MINUTE
|
Raggruppa le date per ora e minuto utilizzando un sistema di 24 ore, ad esempio 19:45. |
HOUR_MINUTE_AMPM
|
Raggruppa le date per ora e minuto utilizzando un sistema di 12 ore, ad esempio 19:45. La designazione AM/PM viene tradotta in base alle impostazioni internazionali del foglio di lavoro. |
DAY_OF_WEEK
|
Raggruppa le date per giorno della settimana, ad esempio domenica. I giorni della settimana verranno tradotti in base alle impostazioni internazionali del foglio di lavoro. |
DAY_OF_YEAR
|
Raggruppa le date per giorno dell'anno, da 1 a 366. Tieni presente che le date successive al 29 febbraio rientrano in bucket diversi negli anni bisestili rispetto agli anni non bisestili. |
DAY_OF_MONTH
|
Raggruppa le date per giorno del mese, da 1 a 31. |
DAY_MONTH
|
Raggruppa le date per giorno e mese, ad esempio 22-Nov. Il mese viene tradotto in base alle impostazioni internazionali del foglio di lavoro. |
MONTH
|
Raggruppa le date per mese, ad esempio Nov. Il mese viene tradotto in base alle impostazioni internazionali del foglio di lavoro. |
QUARTER
|
Raggruppa le date per trimestre, ad esempio 1° trimestre (che rappresenta gennaio-marzo). |
YEAR
|
Raggruppa le date per anno, ad esempio 2008. |
YEAR_MONTH
|
Raggruppa le date per anno e mese, ad esempio 2008-Nov. Il mese viene tradotto in base alle impostazioni internazionali del foglio di lavoro. |
YEAR_QUARTER
|
Raggruppa le date per anno e trimestre, ad esempio 4° trimestre 2008. |
YEAR_MONTH_DAY
|
Raggruppa le date per anno, mese e giorno, ad esempio 22-11-2008. |
PivotGroupLimit
Il limite di conteggio per righe o colonne nel gruppo pivot.
Rappresentazione JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
Campi | |
---|---|
countLimit
|
Il limite di conteggio. |
applyOrder
|
L'ordine in cui il limite di gruppo viene applicato alla tabella pivot. I limiti dei gruppi pivot vengono applicati dal numero di ordine più basso a quello più alto. I numeri degli ordini sono normalizzati in numeri interi consecutivi a partire da 0.
Per la richiesta di scrittura, per personalizzare completamente l'applicazione degli ordini, tutti i limiti del gruppo di pivot devono avere questo campo impostato con un numero univoco. In caso contrario, l'ordine è determinato dall'indice nell'elenco
|
PivotFilterCriteria
Criteri per mostrare/nascondere le righe in una tabella pivot.
Rappresentazione JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
Campi | |
---|---|
visibleValues[]
|
Valori da includere. I valori non elencati qui sono esclusi. |
condition
|
Una condizione che deve essere vera affinché i valori vengano visualizzati. (
I valori delle condizioni che fanno riferimento ad intervalli in notazione A1 vengono valutati in base al foglio della tabella pivot. I riferimenti vengono trattati in modo assoluto, quindi non vengono inseriti nella riga sottostante della tabella pivot. Ad esempio, un valore della condizione di
È possibile fare riferimento ai dati di origine della tabella pivot in base al nome dell'intestazione della colonna. Ad esempio, se i dati di origine hanno colonne denominate "Entrate" e "Costo" e viene applicata una condizione alla colonna "Entrate" con tipo
|
visibleByDefault
|
Indica se i valori sono visibili per impostazione predefinita. Se è true, i valori
|
PivotFilterSpec
I criteri di filtro della tabella pivot associati a un offset della colonna di origine specifico.
Rappresentazione JSON |
---|
{ "filterCriteria": { object ( |
Campi | |
---|---|
filterCriteria
|
I criteri per la colonna. |
Campo unione
source . La colonna di origine a cui si applica questo filtro.
source
può essere solo uno dei seguenti:
|
|
columnOffsetIndex
|
Lo spostamento della colonna basato su zero dell'intervallo di origine. |
dataSourceColumnReference
|
Il riferimento alla colonna dell'origine dati. |
PivotValue
La definizione di come deve essere calcolato un valore in una tabella pivot.
Rappresentazione JSON |
---|
{ "summarizeFunction": enum ( |
Campi | |
---|---|
summarizeFunction
|
Una funzione per riepilogare il valore. Se è impostato |
name
|
Un nome da utilizzare per il valore. |
calculatedDisplayType
|
Se specificato, indica che i valori pivot devono essere visualizzati come risultato di un calcolo con un altro valore pivot. Ad esempio, se calculatedDisplayType è specificato come PERCENT_OF_GRAND_TOTAL, tutti i valori pivot vengono visualizzati come percentuale del totale generale. Nell'editor di Fogli, questa opzione è indicata come "Mostra come" nella sezione dei valori di una tabella pivot. |
Campo unione
value . I dati da utilizzare per i valori nella tabella pivot. È necessario impostare un solo valore.
value
può essere solo uno dei seguenti:
|
|
sourceColumnOffset
|
L'offset di colonna dell'intervallo di origine da cui viene letto questo valore.
Ad esempio, se l'origine era
|
formula
|
Una formula personalizzata per calcolare il valore. La formula deve iniziare con un carattere
|
dataSourceColumnReference
|
Il riferimento alla colonna dell'origine dati da cui viene letto questo valore. |
PivotValueSummarizeFunction
Una funzione per riepilogare un valore pivot.
Enum | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
L'impostazione predefinita, non da utilizzare. |
SUM
|
Corrisponde alla funzione
SUM .
|
COUNTA
|
Corrisponde alla funzione
COUNTA .
|
COUNT
|
Corrisponde alla funzione
COUNT .
|
COUNTUNIQUE
|
Corrisponde alla funzione
COUNTUNIQUE .
|
AVERAGE
|
Corrisponde alla funzione
AVERAGE .
|
MAX
|
Corrisponde alla funzione
MAX .
|
MIN
|
Corrisponde alla funzione
MIN .
|
MEDIAN
|
Corrisponde alla funzione
MEDIAN .
|
PRODUCT
|
Corrisponde alla funzione
PRODUCT .
|
STDEV
|
Corrisponde alla funzione
STDEV .
|
STDEVP
|
Corrisponde alla funzione
STDEVP .
|
VAR
|
Corrisponde alla funzione
VAR .
|
VARP
|
Corrisponde alla funzione
VARP .
|
CUSTOM
|
Indica che la formula deve essere utilizzata così com'è. Valido solo se è stato impostato
PivotValue.formula .
|
NONE
|
Indica che il valore è già riassunto e che la funzione di riepilogo non è specificata esplicitamente. Utilizzato per le tabelle pivot dell'origine dati di Looker in cui il valore è già riassunto. |
PivotValueCalculatedDisplayType
I possibili modi in cui i valori pivot possono essere calcolati per la visualizzazione.
Enum | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Valore predefinito, non da utilizzare. |
PERCENT_OF_ROW_TOTAL
|
Mostra i valori pivot come percentuale dei valori totali delle righe. |
PERCENT_OF_COLUMN_TOTAL
|
Mostra i valori pivot come percentuale dei valori totali delle colonne. |
PERCENT_OF_GRAND_TOTAL
|
Mostra i valori pivot come percentuale dei valori del totale generale. |
PivotValueLayout
Il layout dei valori pivot.
Enum | |
---|---|
HORIZONTAL
|
I valori vengono disposti orizzontalmente (come colonne). |
VERTICAL
|
I valori sono disposti verticalmente (come righe). |