PivotTable
피벗 테이블
JSON 표현 |
---|
{ "rows": [ { object ( |
필드 | |
---|---|
rows[]
|
피벗 테이블의 각 행 그룹입니다. |
columns[]
|
피벗 테이블의 각 열 그룹입니다. |
criteria
|
소스 열 오프셋별 필터 매핑(선택사항). 필터는 데이터를 피벗 테이블로 집계하기 전에 적용됩니다. 맵의 키는 필터링하려는 소스 범위의 열 오프셋이고 값은 해당 열의 기준입니다.
예를 들어 소스가
이 필드는 지원 중단되었으며 |
filterSpecs[]
|
피벗 테이블의 데이터를 집계하기 전에 소스 열에 적용된 필터입니다.
|
values[]
|
피벗 테이블에 포함할 값 목록입니다. |
valueLayout
|
값을 가로 (열)로 나열할지 세로 (행)로 나열할지 지정합니다. |
dataExecutionStatus
|
출력 전용입니다. 데이터 소스 피벗 테이블의 데이터 실행 상태입니다. |
공용체 필드 source_data 입니다. 피벗 테이블 데이터의 소스입니다.
source_data 는 다음 중 하나여야 합니다.
|
|
source
|
피벗 테이블에서 데이터를 읽는 범위입니다. |
dataSourceId
|
피벗 테이블에서 데이터를 읽는 데이터 소스의 ID입니다. |
PivotGroup
피벗 테이블의 단일 그룹 (행 또는 열)입니다.
JSON 표현 |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
필드 | |
---|---|
showTotals
|
피벗 테이블에 이 그룹의 합계가 포함되어야 하는 경우 true입니다. |
valueMetadata[]
|
그룹의 값에 관한 메타데이터입니다. |
sortOrder
|
이 그룹의 값을 정렬할 순서입니다. |
valueBucket
|
정렬할 반대 피벗 그룹의 버킷입니다. 지정하지 않으면 이 그룹의 값을 기준으로 알파벳순으로 정렬됩니다. |
repeatHeadings
|
이 피벗 그룹의 제목을 반복해야 하는 경우 true입니다. 이는 행 그룹화에만 유효하며 열에서는 무시됩니다. 기본적으로 Google에서는 동일한 상위 수준의 제목을 표시하지 않음으로써 제목의 중복을 최소화합니다. 예를 들어 아래의 세 번째 행은 '3월 분기 1'에 해당하지만 '분기 1'은 이전 행과 중복되므로 표시되지 않습니다. repeatHeadings를 true로 설정하면 '2월'과 '3월'에 '1분기'가 반복됩니다.
|
label
|
맞춤설정할 수 있는 행/열 그룹에 사용할 라벨입니다. 예를 들어 다음 피벗 테이블에서 행 라벨은
|
groupRule
|
이 행/열 그룹에 적용할 그룹 규칙입니다. |
groupLimit
|
이 피벗 그룹에 적용할 행 또는 열의 개수 제한입니다. |
공용체 필드 source 입니다. 피벗 그룹의 데이터 소스입니다.
source 는 다음 중 하나여야 합니다.
|
|
sourceColumnOffset
|
이 그룹화가 기반으로 하는 소스 범위의 열 오프셋입니다.
예를 들어 소스가 |
dataSourceColumnReference
|
이 그룹화가 기반으로 하는 데이터 소스 열에 대한 참조입니다. |
PivotGroupValueMetadata
피벗 그룹의 값에 관한 메타데이터입니다.
JSON 표현 |
---|
{
"value": {
object ( |
필드 | |
---|---|
value
|
메타데이터에 해당하는 계산된 값입니다. 값이 계산되므로 |
collapsed
|
값에 해당하는 데이터가 접힌 경우 true입니다. |
PivotGroupSortValueBucket
피벗 그룹에서 정렬에 사용할 값에 관한 정보입니다.
JSON 표현 |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
필드 | |
---|---|
valuesIndex
|
이 그룹의 값을 정렬하는 기준이 되는 |
buckets[]
|
정렬할 값을 선택할 버킷을 결정합니다. 예를 들어 행 그룹이 1개이고 열 그룹이 2개인 피벗 테이블에서 행 그룹은 최대 2개의 값을 표시할 수 있습니다. 첫 번째 값은 첫 번째 열 그룹 내의 값에 해당하고 두 번째 값은 두 번째 열 그룹의 값에 해당합니다. 값이 표시되지 않으면 열 그룹의 '총계'에 따라 행을 정렬해야 함을 나타냅니다. 단일 값이 표시되면 해당 버킷의 '총계'를 사용하는 것과 같습니다. |
PivotGroupRule
각 개별 값을 분류하는 대신 소스 데이터 열의 값에 대한 버케트를 정의하는 PivotGroup
의 선택적 설정입니다. 소스 데이터의 각 열에 그룹 규칙이 있는 PivotGroup
는 하나만 추가할 수 있지만, 특정 열에는 규칙이 있는 PivotGroup
와 규칙이 없는 PivotGroup
를 모두 추가할 수 있습니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드 rule 입니다. PivotGroup 에 적용할 규칙입니다.
rule 는 다음 중 하나여야 합니다.
|
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
ManualRule
소스 데이터 열의 값을 원하는 이름을 가진 버킷으로 수동으로 정리할 수 있습니다. 예를 들어 주별로 인구를 집계하는 피벗 테이블은 다음과 같습니다.
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
수동 그룹 규칙에 그룹 목록 (예: groupName = 'Central', items = ['AL', 'AR', 'IA', ...])을 제공하여 시간대별 인구를 집계하는 피벗 테이블로 변환할 수 있습니다. 소스 데이터에 시간대 열을 추가하고 피벗 테이블을 조정하여 유사한 효과를 얻을 수도 있습니다.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
JSON 표현 |
---|
{
"groups": [
{
object ( |
필드 | |
---|---|
groups[]
|
그룹 이름 목록과 각 그룹 이름에 매핑되는 소스 데이터의 해당 항목입니다. |
ManualRuleGroup
그룹 이름과 이 이름으로 그룹에 배치해야 하는 소스 데이터의 항목 목록입니다.
JSON 표현 |
---|
{ "groupName": { object ( |
필드 | |
---|---|
groupName
|
그룹 이름입니다. 문자열이어야 합니다. 지정된 |
items[]
|
이 그룹에 배치해야 하는 소스 데이터의 항목입니다. 각 항목은 문자열, 숫자 또는 불리언일 수 있습니다. 항목은 지정된 |
HistogramRule
소스 데이터 열의 숫자 값을 일정한 크기의 버킷으로 구성할 수 있습니다. HistogramRule.start
부터 HistogramRule.end
까지의 모든 값은 크기가 HistogramRule.interval
인 그룹에 배치됩니다. 또한 HistogramRule.start
미만의 모든 값은 한 그룹에 배치되고 HistogramRule.end
초과 값은 다른 그룹에 배치됩니다. HistogramRule.interval
만 필요하지만 HistogramRule.start
및 HistogramRule.end
가 모두 제공된 경우 HistogramRule.start
이 HistogramRule.end
보다 작아야 합니다. 예를 들어 행이 50개가 넘는 연령별 평균 구매 금액을 보여주는 피벗 테이블은 다음과 같습니다.
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
HistogramRule.start
이 25이고 HistogramRule.interval
이 20이며 HistogramRule.end
이 65인 히스토그램 그룹 규칙을 적용하여 아래와 같은 피벗 테이블로 변환할 수 있습니다.
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
JSON 표현 |
---|
{ "interval": number, "start": number, "end": number } |
필드 | |
---|---|
interval
|
생성된 버킷의 크기입니다. 양수여야 합니다. |
start
|
항목이 일정한 크기의 버킷에 배치되는 최솟값입니다. 시작 아래의 값은 하나의 버킷으로 그룹화됩니다. 이 필드는 선택사항입니다. |
end
|
항목이 일정한 크기의 버킷에 배치되는 최대 값입니다. 끝 값보다 큰 값은 하나의 버킷으로 그룹화됩니다. 이 필드는 선택사항입니다. |
DateTimeRule
소스 데이터 열의 날짜/시간 값 중 선택한 부분을 기준으로 버킷으로 정리할 수 있습니다. 예를 들어 날짜별 판매 거래를 보여주는 피벗 테이블을 살펴보겠습니다.
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
YEAR_MONTH DateTimeRuleType
로 날짜-시간 그룹 규칙을 적용하면 다음과 같은 피벗 테이블이 생성됩니다.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
JSON 표현 |
---|
{
"type": enum ( |
필드 | |
---|---|
type
|
적용할 날짜 시간 그룹화 유형입니다. |
DateTimeRuleType
사용 가능한 날짜 시간 그룹화 규칙 유형입니다. 이 문서에서는 스프레드시트 언어가 'en-US'라고 가정하지만, 날짜 및 시간의 실제 렌더링은 일부 규칙 유형에 스프레드시트의 언어를 사용합니다.
열거형 | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
기본 유형이며 사용하지 마세요. |
SECOND
|
0~59초 단위로 날짜를 그룹화합니다. |
MINUTE
|
0~59분으로 날짜를 그룹화합니다. |
HOUR
|
0~23 사이의 24시간제를 사용하여 시간별로 날짜를 그룹화합니다. |
HOUR_MINUTE
|
24시간 시스템(예: 19:45)을 사용하여 시간과 분으로 날짜를 그룹화합니다. |
HOUR_MINUTE_AMPM
|
12시간제를 사용하여 시간과 분으로 날짜를 그룹화합니다(예:오후 7시 45분). AM/PM 지정은 스프레드시트 언어를 기반으로 번역됩니다. |
DAY_OF_WEEK
|
일요일과 같이 요일별로 날짜를 그룹화합니다. 요일은 스프레드시트 언어를 기반으로 번역됩니다. |
DAY_OF_YEAR
|
1~366 사이의 연중 일로 날짜를 그룹화합니다. 2월 29일 이후의 날짜는 윤년과 윤년이 아닌 해에 따라 다른 버킷에 속합니다. |
DAY_OF_MONTH
|
1~31일의 일별로 날짜를 그룹화합니다. |
DAY_MONTH
|
날짜를 일과 월별로 그룹화합니다(예: 11월 22일). 월은 스프레드시트 언어에 따라 번역됩니다. |
MONTH
|
날짜를 월별로 그룹화합니다(예: 11월). 월은 스프레드시트 언어에 따라 번역됩니다. |
QUARTER
|
분기별로 날짜를 그룹화합니다(예: 1분기(1월~3월)). |
YEAR
|
연도별로 날짜를 그룹화합니다(예: 2008년). |
YEAR_MONTH
|
연도 및 월별로 날짜를 그룹화합니다(예: 2008-Nov). 월은 스프레드시트 언어에 따라 번역됩니다. |
YEAR_QUARTER
|
연도 및 분기별로 날짜를 그룹화합니다(예: 2008년 4분기). |
YEAR_MONTH_DAY
|
연도, 월, 일(예: 2008-11-22)별로 날짜를 그룹화합니다. |
PivotGroupLimit
피벗 그룹의 행 또는 열에 대한 개수 제한입니다.
JSON 표현 |
---|
{ "countLimit": integer, "applyOrder": integer } |
필드 | |
---|---|
countLimit
|
개수 제한입니다. |
applyOrder
|
그룹 한도가 피벗 테이블에 적용되는 순서입니다. 피벗 그룹 한도는 낮은 순서 번호부터 높은 순서 번호로 적용됩니다. 순서 번호는 0부터 연속된 정수로 정규화됩니다.
쓰기 요청의 경우 적용 순서를 완전히 맞춤설정하려면 모든 피벗 그룹 한도에 이 필드를 고유한 숫자로 설정해야 합니다. 그렇지 않으면 순서는 |
PivotFilterCriteria
피벗 테이블에서 행을 표시/숨기는 기준입니다.
JSON 표현 |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
필드 | |
---|---|
visibleValues[]
|
포함해야 하는 값입니다. 여기에 나열되지 않은 값은 제외됩니다. |
condition
|
값이 표시되려면 반드시 '참'이어야 하는 조건입니다. (
A1 표기법으로 범위를 참조하는 조건 값은 피벗 테이블 시트를 기준으로 평가됩니다. 참조는 절대적으로 처리되므로 피벗 테이블 아래로 채워지지 않습니다. 예를 들어 '피벗 테이블 1'의 조건 값
피벗 테이블의 소스 데이터는 열 헤더 이름으로 참조할 수 있습니다. 예를 들어 소스 데이터에 '수익' 및 '비용'이라는 열이 있고 '수익' 열에 유형이 |
visibleByDefault
|
기본적으로 값이 표시되는지 여부입니다. true인 경우 |
PivotFilterSpec
특정 소스 열 오프셋과 연결된 피벗 테이블 필터 기준입니다.
JSON 표현 |
---|
{ "filterCriteria": { object ( |
필드 | |
---|---|
filterCriteria
|
열의 기준입니다. |
공용체 필드 source 입니다. 이 필터가 적용되는 소스 열입니다.
source 는 다음 중 하나여야 합니다.
|
|
columnOffsetIndex
|
소스 범위의 0부터 시작하는 열 오프셋입니다. |
dataSourceColumnReference
|
데이터 소스 열에 대한 참조입니다. |
PivotValue
피벗 테이블의 값을 계산하는 방법에 관한 정의입니다.
JSON 표현 |
---|
{ "summarizeFunction": enum ( |
필드 | |
---|---|
summarizeFunction
|
값을 요약하는 함수입니다. |
name
|
값에 사용할 이름입니다. |
calculatedDisplayType
|
지정된 경우 피벗 값이 다른 피벗 값을 사용한 계산의 결과로 표시되어야 함을 나타냅니다. 예를 들어 calculatedDisplayType이 PERCENT_OF_GRAND_TOTAL로 지정된 경우 모든 피벗 값이 총계의 백분율로 표시됩니다. Sheets 편집기에서는 피벗 테이블의 값 섹션에 '표시 형식'이라고 표시됩니다. |
공용체 필드 value 입니다. 피벗 테이블의 값에 사용할 데이터입니다. 정확히 하나의 값을 설정해야 합니다.
value 는 다음 중 하나여야 합니다.
|
|
sourceColumnOffset
|
이 값이 읽는 소스 범위의 열 오프셋입니다.
예를 들어 소스가 |
formula
|
값을 계산하는 맞춤 수식입니다. 수식은 |
dataSourceColumnReference
|
이 값이 읽는 데이터 소스 열에 대한 참조입니다. |
PivotValueSummarizeFunction
피벗 값을 요약하는 함수입니다.
열거형 | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
기본값이며 사용하지 마세요. |
SUM
|
SUM 함수에 해당합니다.
|
COUNTA
|
COUNTA 함수에 해당합니다.
|
COUNT
|
COUNT 함수에 해당합니다.
|
COUNTUNIQUE
|
COUNTUNIQUE 함수에 해당합니다.
|
AVERAGE
|
AVERAGE 함수에 해당합니다.
|
MAX
|
MAX 함수에 해당합니다.
|
MIN
|
MIN 함수에 해당합니다.
|
MEDIAN
|
MEDIAN 함수에 해당합니다.
|
PRODUCT
|
PRODUCT 함수에 해당합니다.
|
STDEV
|
STDEV 함수에 해당합니다.
|
STDEVP
|
STDEVP 함수에 해당합니다.
|
VAR
|
VAR 함수에 해당합니다.
|
VARP
|
VARP 함수에 해당합니다.
|
CUSTOM
|
수식을 있는 그대로 사용해야 함을 나타냅니다. PivotValue.formula 가 설정된 경우에만 유효합니다.
|
NONE
|
값이 이미 요약되었으며 요약 함수가 명시적으로 지정되지 않았음을 나타냅니다. 값이 이미 요약된 Looker 데이터 소스 피벗 테이블에 사용됩니다. |
PivotValueCalculatedDisplayType
피벗 값을 표시하기 위해 계산할 수 있는 방법입니다.
열거형 | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
기본값이며 사용할 수 없습니다. |
PERCENT_OF_ROW_TOTAL
|
피벗 값을 행 합계 값의 백분율로 표시합니다. |
PERCENT_OF_COLUMN_TOTAL
|
피벗 값을 열 합계 값의 백분율로 표시합니다. |
PERCENT_OF_GRAND_TOTAL
|
피벗 값을 총계 값의 백분율로 표시합니다. |
PivotValueLayout
피벗 값의 레이아웃입니다.
열거형 | |
---|---|
HORIZONTAL
|
값이 열로 가로로 배치됩니다. |
VERTICAL
|
값은 행으로 세로로 배치됩니다. |