PivotTable
Tabela przestawna.
Zapis JSON |
---|
{ "rows": [ { object ( |
Pola | |
---|---|
rows[]
|
Każde grupowanie wierszy w tabeli przestawnej. |
columns[]
|
Każde grupowanie kolumn w tabeli przestawnej. |
criteria
|
Opcjonalne mapowanie filtrów na przesunięcie kolumny źródłowej. Filtry są stosowane przed zgrupowaniem danych w tabeli przestawnej. Klucz mapy to przesunięcie kolumny w zakresie źródłowym, który chcesz odfiltrować, a wartość to kryterium dla tej kolumny.
Jeśli np. źródło to
To pole zostało wycofane i zastąpione
|
filterSpecs[]
|
Filtry zastosowane do kolumn źródłowych przed agregowaniem danych do tabeli przestawnej.
Obie opcje
|
values[]
|
Lista wartości do uwzględnienia w tabeli przestawnej. |
valueLayout
|
Określa, czy wartości mają być wymienione poziomo (jako kolumny) czy pionowo (jako wiersze). |
dataExecutionStatus
|
Tylko dane wyjściowe. Stan wykonania danych w tabelach przestawnych źródła danych. |
Pole uniisource_data . Źródło danych tabeli przestawnej.
source_data
może być tylko jednym z tych elementów:
|
|
source
|
Zakres, z którego tabela przestawna odczytuje dane. |
dataSourceId
|
Identyfikator źródła danych, z którego tabela przestawna odczytuje dane. |
PivotGroup
Pojedyncze grupowanie (wiersza lub kolumny) w tabeli przestawnej.
Zapis JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Pola | |
---|---|
showTotals
|
Wartość Prawda, jeśli tabela przestawna ma zawierać sumy dla tego grupowania. |
valueMetadata[]
|
Metadane dotyczące wartości w grupowaniu. |
sortOrder
|
Kolejność wartości w tej grupie powinna być sortowana. |
valueBucket
|
Zasobnik przeciwnej grupy przestawnej, według którego ma być sortowana. Jeśli nie określono tej wartości, sortowanie jest sortowane alfabetycznie według wartości tej grupy. |
repeatHeadings
|
Wartość Prawda, jeśli nagłówki w tej grupie przestawień mają być powtarzane. Ta opcja ma zastosowanie tylko do grupowania wierszy i jest ignorowana w kolumnach. Domyślnie ograniczamy liczbę powtórzeń nagłówków, nie wyświetlając nagłówków wyższego poziomu w miejscach, w których są one takie same. Na przykład, mimo że trzeci wiersz poniżej odpowiada adresowi „I mar” lub „Q1” nie jest wyświetlany, ponieważ jest nadmiarowy w poprzednich wierszach. Ustawienie opcji repeatHeadings na „PRAWDA” spowoduje powtórzenie wartości „Q1” w przypadku „Feb” i „Mar”.
|
label
|
Etykiety, których chcesz używać w przypadku grup wierszy lub kolumn, które można dostosowywać. Na przykład w poniższej tabeli przestawnej etykieta wiersza to
|
groupRule
|
Reguła grupy, która ma być stosowana do tej grupy wierszy lub kolumn. |
groupLimit
|
Limit liczby wierszy lub kolumn, który ma być stosowany w przypadku tej grupy przestawnej. |
Pole sumy
source Źródło danych grupy tabeli przestawnej.
source może być tylko jedną z tych wartości:
|
|
sourceColumnOffset
|
Przesunięcie kolumny zakresu źródłowego, na którym opiera się ta grupowanie.
Jeśli np. źródło to
|
dataSourceColumnReference
|
Odniesienie do kolumny źródła danych, na której podstawie tworzone jest to grupowanie. |
PivotGroupValueMetadata
Metadane dotyczące wartości w grupowaniu elementów tabeli przestawnej.
Zapis JSON |
---|
{
"value": {
object ( |
Pola | |
---|---|
value
|
Obliczona wartość, z którą są zgodne metadane. (Pamiętaj, że
|
collapsed
|
Prawda, jeśli dane powiązane z wartością są zwinięte. |
PivotGroupSortValueBucket
Informacje o tym, które wartości w grupie przestawnej powinny być używane do sortowania.
Zapis JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
Pola | |
---|---|
valuesIndex
|
Odstęp w liście |
buckets[]
|
Określa zasobnik, z którego wybierane są wartości do sortowania. Na przykład w tabeli przestawnej z 1 grupą wierszy i 2 grupami kolumn grupa wierszy może zawierać maksymalnie 2 wartości. Pierwsza wartość odpowiada wartości w pierwszej grupie kolumn, a druga wartość w drugiej grupie kolumn. Jeśli na liście nie ma żadnych wartości, oznacza to, że wiersz powinien zostać posortowany według „Suma całkowita” nad grupami kolumn. Jeśli podana jest tylko jedna wartość, odpowiada ona wartości „Łącznej” w danym zbiorze. |
PivotGroupRule
Opcjonalne ustawienie PivotGroup
, które definiuje przedziały dla wartości w kolumnie danych źródłowych zamiast wyodrębniania poszczególnych wartości. Do każdej kolumny w źródłowych danych można dodać tylko jedną funkcję PivotGroup
z regułą grupową, ale do każdej kolumny możesz dodać funkcję PivotGroup
z regułą i funkcję PivotGroup
bez reguły.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole uniirule . Regułę, która ma być stosowana do PivotGroup .
rule
może być tylko jednym z tych elementów:
|
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
ManualRule
Umożliwia ręczne porządkowanie wartości w źródłowej kolumnie danych w zasobniki o wybranych przez siebie nazwach. Na przykład tabela przestawna, która agreguje dane o liczbie ludności według stanu:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
może zostać przekształcona w tabelę przestawną, która agreguje dane o populacji według strefy czasowej, podając listę grup (np. groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) w regułach grupowych ręcznych. Pamiętaj, że podobny efekt można uzyskać, dodając do danych źródłowych kolumnę strefy czasowej i dostosowując tabelę przestawną.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
Zapis JSON |
---|
{
"groups": [
{
object ( |
Pola | |
---|---|
groups[]
|
Lista nazw grup i odpowiadających im produktów z danych źródłowych, które są mapowane na każdą nazwę grupy. |
ManualRuleGroup
Nazwa grupy i lista elementów z danych źródłowych, które powinny zostać umieszczone w grupie o tej nazwie.
Zapis JSON |
---|
{ "groupName": { object ( |
Pola | |
---|---|
groupName
|
Nazwa grupy, która musi być ciągiem znaków. Każda grupa w danym
|
items[]
|
Elementy w danych źródłowych, które powinny zostać umieszczone w tej grupie. Każdy element może być ciągiem tekstowym, liczbą lub wartością logiczną. Elementy mogą występować w maksymalnie jednej grupie w danej grupie
|
HistogramRule
Umożliwia grupowanie wartości liczbowych w kolumnie danych źródłowych w zbiorniki o stałym rozmiarze. Wszystkie wartości z
HistogramRule.start
do
HistogramRule.end
są umieszczane w grupach rozmiarów
HistogramRule.interval
Dodatkowo wszystkie wartości poniżej
HistogramRule.start
są umieszczane w jednej grupie, a wszystkie wartości powyżej
HistogramRule.end
są umieszczane w innej. Tylko
HistogramRule.interval
jest wymagane, jednak jeśli
HistogramRule.start
oraz
HistogramRule.end
i jedną z tych grup,
HistogramRule.start
musi być mniejsze niż
HistogramRule.end
. Na przykład tabela przestawna pokazująca średnią kwotę zakupu według grupy wiekowej ma ponad 50 wierszy:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
może zostać przekształcona w tabelę przestawną, która wygląda jak tabela poniżej, po zastosowaniu reguły grupy histogramu z wartością HistogramRule.start
równą 25, wartością HistogramRule.interval
równą 20 i wartością HistogramRule.end
równą 65.
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
Zapis JSON |
---|
{ "interval": number, "start": number, "end": number } |
Pola | |
---|---|
interval
|
Rozmiar tworzonych zasobników. Musi być liczbą dodatnią. |
start
|
Minimalna wartość, z jaką elementy są umieszczane w segmentach o stałej wielkości. Wartości poniżej wartości początkowej są grupowane w jednym zasobniku. To pole jest opcjonalne. |
end
|
Maksymalna wartość, przy której elementy są umieszczane w zasobnikach o stałym rozmiarze. Wartości znajdujące się powyżej końca są umieszczone w jednym zasobniku. To pole jest opcjonalne. |
DateTimeRule
Umożliwia podział wartości daty i godziny w kolumnie danych źródłowych na segmenty na podstawie wybranych elementów daty lub godziny. Rozważ na przykład tabelę przestawną z transakcjami sprzedaży posortowanymi według daty:
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
Zastosowanie reguły grupy daty i godziny ze
DateTimeRuleType
z YEAR_MONTH daje następującą tabelę przestawną.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
Zapis JSON |
---|
{
"type": enum ( |
Pola | |
---|---|
type
|
Typ grupowania daty i godziny, który ma być zastosowany. |
DateTimeRuleType
Dostępne typy reguł grupowania „data i godzina”. Ta dokumentacja zakłada, że językiem arkusza kalkulacyjnego jest „en-US”, ale w przypadku niektórych typów reguł do renderowania dat i godzin używany jest język arkusza kalkulacyjnego.
Wartości w polu enum | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Jest to typ domyślny – nie używaj. |
SECOND
|
Grupuj daty według sekund (od 0 do 59). |
MINUTE
|
Grupuj daty według minut (od 0 do 59). |
HOUR
|
Grupuj daty według godzin w systemie 24-godzinnym (od 0 do 23). |
HOUR_MINUTE
|
Pogrupuj daty według godziny i minut w systemie 24-godzinnym, np. 19:45. |
HOUR_MINUTE_AMPM
|
Daty pogrupuj według godziny i minuty w systemie 12-godzinnym, np. 19:45. Oznaczenie AM/PM jest tłumaczone na podstawie języka arkusza kalkulacyjnego. |
DAY_OF_WEEK
|
Pogrupuj daty według dnia tygodnia, np. niedzieli. Dni tygodnia będą tłumaczone na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
DAY_OF_YEAR
|
Grupuj daty według dnia roku, od 1 do 366. Pamiętaj, że daty po 29 lutego trafiają do innych grup w latach przestępnych niż w latach bez przestępnych. |
DAY_OF_MONTH
|
Grupuj daty według dnia miesiąca, od 1 do 31. |
DAY_MONTH
|
Grupuj daty według dnia i miesiąca, np. 22-Nov. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
MONTH
|
grupowanie dat według miesiąca, np. listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego; |
QUARTER
|
Grupuj daty według kwartału, np. Q1 (styczeń–marzec). |
YEAR
|
Możesz pogrupować daty według roku, np. 2008 r. |
YEAR_MONTH
|
Możesz grupować daty według roku i miesiąca, np. 2008–listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
YEAR_QUARTER
|
Grupuj daty według roku i kwartału, np. 2008 IV kwartał. |
YEAR_MONTH_DAY
|
Grupuj daty według roku, miesiąca i dnia, np. 2008-11-22. |
PivotGroupLimit
Limit liczby wierszy lub kolumn w grupie przestawnej.
Zapis JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
Pola | |
---|---|
countLimit
|
Limit liczby. |
applyOrder
|
Kolejność, w jakiej ograniczenie grupy jest stosowane do tabeli przestawnej. Limity grup przestawnych są stosowane od najniższego do wyższego numeru kolejności. Numery zamówień są normalizowane do kolejnych liczb całkowitych, zaczynając od 0.
W przypadku żądania zapisu, aby w pełni dostosować kolejność stosowania, wszystkie limity grup przekształceń powinny mieć to pole ustawione na unikalny numer. W przeciwnym razie kolejność jest określana przez indeks w sekcji
|
PivotFilterCriteria
Kryteria wyświetlania/ukrywania wierszy w tabeli przestawnej.
Zapis JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
Pola | |
---|---|
visibleValues[]
|
Wartości, które powinny być uwzględnione. Wartości, których nie ma na tej liście, są wykluczane. |
condition
|
Warunek, który musi być spełniony, aby wartości były wyświetlane. (
Wartości warunków, które odwołują się do zakresów w notacji A1, są oceniane w stosunku do arkusza tabeli przestawnej. Odwołania są traktowane absolutnie, więc nie są wypełniane w tabeli przestawnej. Na przykład wartość warunku
Do danych źródłowych tabeli przestawnej można się odwoływać za pomocą nazwy nagłówka kolumny. Jeśli np. dane źródłowe zawierają kolumny o nazwie „Przychody” i „Koszt” i zostanie zastosowany warunek w kolumnie „Przychody”, kolumna z typem
|
visibleByDefault
|
Określa, czy wartości są domyślnie widoczne. Jeśli ma wartość prawda, parametr
|
PivotFilterSpec
Kryteria filtrowania tabeli przestawnej powiązane z konkretnym przesunięciem kolumny źródłowej.
Zapis JSON |
---|
{ "filterCriteria": { object ( |
Pola | |
---|---|
filterCriteria
|
Kryteria kolumny. |
Pole uniisource . Kolumna źródłowa, do której ma zastosowanie dany filtr.
source może być tylko jedną z tych wartości:
|
|
columnOffsetIndex
|
Od zera przesunięcie kolumny zakresu źródłowego. |
dataSourceColumnReference
|
Odwołuje się do kolumny źródła danych. |
PivotValue
Definicja sposobu obliczania wartości w tabeli przestawnej.
Zapis JSON |
---|
{ "summarizeFunction": enum ( |
Pola | |
---|---|
summarizeFunction
|
Funkcja podsumowująca wartość. Jeśli
|
name
|
Nazwa do użycia dla wartości. |
calculatedDisplayType
|
Jeśli określono tę wartość, wskazuje, że wartości w tabeli przestawnej powinny być wyświetlane jako wynik obliczeń z inną wartością przestawnej. Jeśli na przykład obliczony typ DisplayType jest określony jako PERCENT_OF_GRAND_TOTAL, wszystkie wartości w tabeli przestawnej są wyświetlane jako odsetek całkowitej sumy. W edytorze Arkuszy ta opcja nosi nazwę „Wyświetlaj jako” w sekcji wartości tabeli przestawnej. |
Pole sumy
value Dane, których chcesz używać do wartości w tabeli przestawnej. Musisz ustawić dokładnie jedną wartość.
value może być tylko jedną z tych wartości:
|
|
sourceColumnOffset
|
Przesunięcie kolumny zakresu źródłowego, z którego odczytuje ta wartość.
Jeśli na przykład źródłem było
|
formula
|
niestandardowa formuła służąca do obliczenia wartości; Formuła musi zaczynać się od
|
dataSourceColumnReference
|
Odwołanie do kolumny źródła danych, z której odczytuje ta wartość. |
PivotValueSummarizeFunction
Funkcja do podsumowania wartości w tabeli przestawnej.
Wartości w polu enum | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Domyślna wartość, której nie należy używać. |
SUM
|
Odpowiada
SUM
.
|
COUNTA
|
Odpowiada
COUNTA
.
|
COUNT
|
Odpowiada
COUNT
.
|
COUNTUNIQUE
|
Odpowiada
COUNTUNIQUE
.
|
AVERAGE
|
Odpowiada
AVERAGE
.
|
MAX
|
Odpowiada
MAX
.
|
MIN
|
Odpowiada funkcji MIN .
|
MEDIAN
|
Odpowiada
MEDIAN
.
|
PRODUCT
|
Odpowiada funkcji PRODUCT .
|
STDEV
|
Odpowiada
STDEV
.
|
STDEVP
|
Odpowiada funkcji STDEVP .
|
VAR
|
Odpowiada
VAR
.
|
VARP
|
Odpowiada
VARP
.
|
CUSTOM
|
Wskazuje, że formuła powinna być użyta w postaci oryginalnej. Jest prawidłowa tylko wtedy, gdy ustawiono opcję PivotValue.formula .
|
NONE
|
Wskazuje, że wartość została już podsumowana, a funkcja podsumowywania nie została wyraźnie określona. Używane w tabelach przestawnych źródeł danych Looker, w których wartość jest już podsumowana. |
PivotValueCalculatedDisplayType
Możliwe sposoby obliczania wartości w tabeli przestawnej na potrzeby wyświetlania.
Wartości w polu enum | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Wartość domyślna, nie używaj. |
PERCENT_OF_ROW_TOTAL
|
Pokazuje wartości w tabeli przestawnej jako procent łącznej wartości wierszy. |
PERCENT_OF_COLUMN_TOTAL
|
Pokazuje wartości w tabeli przestawnej jako procent łącznej wartości w kolumnie. |
PERCENT_OF_GRAND_TOTAL
|
Pokazuje wartości w tabeli przestawnej jako odsetek łącznych wartości. |
PivotValueLayout
Układ wartości przestawnych.
Wartości w polu enum | |
---|---|
HORIZONTAL
|
Wartości są układane w poziomie (w postaci kolumn). |
VERTICAL
|
Wartości są rozmieszczone w pionie (jako wiersze). |