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 offset della colonna di origine. I filtri vengono applicati prima di aggregare i dati nella tabella pivot. La chiave della mappa rappresenta l'offset dell'intervallo di origine che vuoi filtrare e il valore è il criterio per quella colonna.
Ad esempio, se l'origine era
Questo campo è deprecato a favore di
|
filterSpecs[]
|
I filtri applicati alle colonne di origine prima di aggregare i dati per la tabella pivot.
Entrambi
|
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 di 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 sta leggendo 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[]
|
I metadati sui valori nel raggruppamento. |
sortOrder
|
L'ordine in cui i valori in questo gruppo devono essere ordinati. |
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. È valido solo per i raggruppamenti di righe e viene ignorato dalle colonne. Per impostazione predefinita, riduciamo al minimo la ripetizione di intestazioni non mostrando intestazioni di livello superiore quando sono uguali. Ad esempio, anche se la terza riga seguente corrisponde a "Q1 Mar", "Q1" non viene visualizzata perché è ridondante con le righe precedenti. L'impostazione di ripetizioneHeadings su true comporterebbe la ripetizione di "Q1" per "Feb" e "Mar".
|
label
|
Le etichette da utilizzare per i gruppi di righe/colonne che possono essere personalizzate. Ad esempio, nella seguente tabella pivot, l'etichetta della riga è
|
groupRule
|
La regola di gruppo da applicare a questo gruppo di righe/colonne. |
groupLimit
|
Il limite al numero di righe o colonne da applicare a questo gruppo pivot. |
Campo di unione
source . L'origine dati del gruppo pivot.
source può essere solo uno dei seguenti:
|
|
sourceColumnOffset
|
L'offset della colonna dell'intervallo di origine su cui si basa questo raggruppamento.
Ad esempio, se l'origine era
|
dataSourceColumnReference
|
Il riferimento alla colonna dell'origine dati su cui si basa questo raggruppamento. |
PivotGroupValueMetadata
Metadati su 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 di 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 per l'ordinamento. 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, mentre il secondo a un valore nel secondo gruppo di colonne. Se non viene elencato alcun valore, significa che la riga deve essere ordinata in base al "Totale generale" dei gruppi di colonne. Se viene elencato un singolo valore, questo corrisponderà all'utilizzo del "Totale" del bucket. |
PivotGroupRule
Un'impostazione facoltativa su un elemento
PivotGroup
che definisce i bucket per i valori nella colonna dei dati di origine anziché suddividere ogni singolo valore. È possibile aggiungere un solo
PivotGroup
con una regola di gruppo per ogni colonna nei dati di origine, anche se per ogni colonna puoi aggiungere sia
PivotGroup
che ha una regola che
PivotGroup
che non ha una regola.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione
rule . La regola da applicare a
PivotGroup .
rule può essere solo uno dei seguenti:
|
|
manualRule
|
Un
|
histogramRule
|
Un
|
dateTimeRule
|
Un
|
ManualRule
Consente di organizzare manualmente i valori di una colonna di dati di origine in bucket con nomi di 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 |
...
+-------+-------------------+
potrebbe essere trasformata in una tabella pivot che aggrega la popolazione per fuso orario fornendo un elenco di gruppi (ad esempio, groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) in base a una regola di gruppo manuale. Tieni presente che puoi ottenere un effetto simile 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 degli elementi corrispondenti dei dati di origine mappati al nome di ciascun gruppo. |
ManualRuleGroup
Un nome di gruppo e un elenco di elementi dai dati di origine che devono essere inseriti nel gruppo con questo nome.
Rappresentazione JSON |
---|
{ "groupName": { object ( |
Campi | |
---|---|
groupName
|
Il nome del gruppo, che deve essere una stringa. Ogni gruppo di 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 al massimo in un gruppo all'interno di un determinato
|
HistogramRule
Consente di organizzare i valori numerici in una colonna di dati di origine in bucket di dimensione costante. Tutti i valori da
HistogramRule.start
a
HistogramRule.end
vengono inseriti in gruppi di dimensioni
HistogramRule.interval
. Inoltre, tutti i valori inferiori a HistogramRule.start
vengono inseriti in un gruppo, mentre tutti i valori superiori a HistogramRule.end
vengono inseriti in un altro. È richiesto solo HistogramRule.interval
, tuttavia se vengono forniti entrambi i valori HistogramRule.start
e HistogramRule.end
, il valore HistogramRule.start
deve essere inferiore a HistogramRule.end
. Ad esempio, una tabella pivot che mostra un importo medio di acquisto per età con più di 50 righe:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
potrebbe essere trasformata in una tabella pivot simile a quella riportata di seguito applicando una regola di gruppo a istogrammi con
HistogramRule.start
di 25,
HistogramRule.interval
di 20 e
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. Deve essere positivo. |
start
|
Il valore minimo al quale gli elementi vengono inseriti in bucket di dimensione costante. I valori inferiori all'inizio sono raggruppati in un unico bucket. Questo campo è facoltativo. |
end
|
Il valore massimo al quale gli elementi vengono inseriti in bucket di dimensione costante. I valori superiori al limite sono raggruppati in un unico bucket. Questo campo è facoltativo. |
DateTimeRule
Consente di organizzare i valori di data e ora in una colonna di dati di origine in bucket in base a parti selezionate dei relativi valori di data o ora. Ad esempio, considera 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
DateTimeRuleType
di YEAR_MONTH nella tabella pivot seguente.
+--------------+--------------+
| 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 disponibili di regole di raggruppamento per data e ora. Questa documentazione presuppone che le impostazioni internazionali del foglio di lavoro siano "en-US", sebbene il rendering effettivo di date e ore utilizzi le impostazioni internazionali del foglio di lavoro per alcuni tipi di regole.
Enum | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Il tipo predefinito, 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 minuti utilizzando un sistema di 24 ore, ad esempio 19:45. |
HOUR_MINUTE_AMPM
|
Raggruppa le date per ora e minuti utilizzando un sistema a 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 in base al 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 categorie diverse 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 novembre. Il mese viene tradotto in base alle impostazioni internazionali del foglio di lavoro. |
QUARTER
|
Raggruppa le date in base al trimestre, ad esempio T1 (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 T4 2008. |
YEAR_MONTH_DAY
|
Raggruppa le date per anno, mese e giorno, ad esempio 2008-11-22. |
PivotGroupLimit
Il limite al numero di 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 gruppi viene applicato alla tabella pivot. I limiti del gruppo pivot vengono applicati dal numero di ordine inferiore a quello superiore. I numeri d'ordine sono normalizzati in numeri interi consecutivi compresi tra 0.
Per le richieste di scrittura, questo campo deve essere impostato con un numero univoco per personalizzare completamente gli ordini di applicazione per tutti i limiti del gruppo pivot. In caso contrario, l'ordine viene 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 che devono essere inclusi. 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 a intervalli nella notazione A1 vengono valutati in base al foglio della tabella pivot. I riferimenti vengono trattati in modo assoluto, quindi non vengono riempiti nella tabella pivot. Ad esempio, il valore della condizione
È possibile fare riferimento ai dati di origine della tabella pivot tramite il nome dell'intestazione di colonna. Ad esempio, se i dati di origine contengono colonne denominate "Entrate" e "Costo" e alla colonna "Entrate" viene applicata una condizione di tipo |
visibleByDefault
|
Indica se i valori sono visibili per impostazione predefinita. Se il valore è true, |
PivotFilterSpec
I criteri di filtro della tabella pivot associati a uno specifico offset della colonna di origine.
Rappresentazione JSON |
---|
{ "filterCriteria": { object ( |
Campi | |
---|---|
filterCriteria
|
I criteri per la colonna. |
Campo di unione
source . La colonna di origine a cui si applica questo filtro.
source può essere solo uno dei seguenti:
|
|
columnOffsetIndex
|
L'offset della colonna in base 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
|
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 computeDisplayType è specificato come PERCENT_OF_GRAND_TOTAL, tutti i valori pivot vengono visualizzati come percentuale del totale complessivo. Nell'editor di Fogli, questo valore è chiamato "Mostra come" nella sezione dei valori di una tabella pivot. |
Campo di unione
value . I dati da utilizzare per i valori della tabella pivot. Deve essere impostato esattamente un valore.
value può essere solo uno dei seguenti:
|
|
sourceColumnOffset
|
L'offset di colonna dell'intervallo di origine da cui legge 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 legge questo valore. |
PivotValueSummarizeFunction
Una funzione per riepilogare un valore pivot.
Enum | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
L'impostazione predefinita: non 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'è. Valida solo se è stato impostato
PivotValue.formula .
|
NONE
|
Indica che il valore è già stato riepilogato e la funzione di riassunto non è specificata in modo esplicito. Utilizzato per le tabelle pivot dell'origine dati di Looker in cui il valore è già riepilogato. |
PivotValueCalculatedDisplayType
Le possibili modalità di calcolo dei valori pivot per la visualizzazione.
Enum | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Valore predefinito, non utilizzare. |
PERCENT_OF_ROW_TOTAL
|
Mostra i valori pivot come percentuale dei valori totali della riga. |
PERCENT_OF_COLUMN_TOTAL
|
Mostra i valori pivot come percentuale dei valori totali della colonna. |
PERCENT_OF_GRAND_TOTAL
|
Mostra i valori pivot come percentuale dei valori totali complessivi. |
PivotValueLayout
Il layout dei valori pivot.
Enum | |
---|---|
HORIZONTAL
|
I valori sono disposti orizzontalmente (come colonne). |
VERTICAL
|
I valori sono disposti verticalmente (come righe). |