기존 데이터 소스 피벗 테이블에 액세스하고 수정합니다. 새 데이터 소스 피벗 테이블을 만들려면 Range.createDataSourcePivotTable(dataSource)
를 사용합니다.
데이터베이스에 연결된 데이터에만 이 클래스를 사용합니다.
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
addColumnGroup(columnName) | PivotGroup | 지정된 데이터 소스 열을 기준으로 새 피벗 열 그룹을 추가합니다. |
addFilter(columnName, filterCriteria) | PivotFilter | 지정된 데이터 소스 열을 기준으로 새 필터를 지정된 필터 기준과 함께 추가합니다. |
addPivotValue(columnName) | PivotValue | 요약 없이 지정된 데이터 소스 열을 기반으로 새 피벗 값을 추가합니다. 함수를 사용하세요. |
addPivotValue(columnName, summarizeFunction) | PivotValue | 지정된 요약이 있는 지정된 데이터 소스 열을 기반으로 새 피벗 값을 추가합니다. 함수를 사용하세요. |
addRowGroup(columnName) | PivotGroup | 지정된 데이터 소스 열을 기반으로 새 피벗 행 그룹을 추가합니다. |
asPivotTable() | PivotTable | 데이터 소스 피벗 테이블을 일반 피벗 테이블 객체로 반환합니다. |
cancelDataRefresh() | DataSourcePivotTable | 현재 실행 중인 경우 이 객체와 관련된 데이터 새로고침을 취소합니다. |
forceRefreshData() | DataSourcePivotTable | 현재 상태와 관계없이 이 객체의 데이터를 새로고침합니다. |
getDataSource() | DataSource | 객체가 연결된 데이터 소스를 가져옵니다. |
getStatus() | DataExecutionStatus | 객체의 데이터 실행 상태를 가져옵니다. |
refreshData() | DataSourcePivotTable | 객체의 데이터를 새로고침합니다. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | 현재 실행이 완료될 때까지 대기하고, 제공된 시간(초)이 지나면 타임아웃됩니다. |
자세한 문서
addColumnGroup(columnName)
지정된 데이터 소스 열을 기준으로 새 피벗 열 그룹을 추가합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnName | String | 피벗 그룹의 기반이 되는 데이터 소스 열 이름입니다. |
리턴
PivotGroup
: 새 피벗 그룹입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addFilter(columnName, filterCriteria)
지정된 데이터 소스 열을 기준으로 새 필터를 지정된 필터 기준과 함께 추가합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnName | String | 필터의 기반이 되는 데이터 소스 열 이름입니다. |
filterCriteria | FilterCriteria | 필터에서 사용하는 기준입니다. |
리턴
PivotFilter
: 새 필터입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName)
요약 없이 지정된 데이터 소스 열을 기반으로 새 피벗 값을 추가합니다. 함수를 사용하세요. Looker 측정에만 해당됩니다.
다음 코드는 Looker 측정항목을 피벗 값으로 추가하는 방법을 보여줍니다.
// TODO(developer): Replace with your spreadsheet ID which has a Looker data source. var spreadsheet = SpreadsheetApp.openById("abcd1234") var datasource = spreadsheet.getDataSources()[0]; var pivotTable = datasource.createDataSourcePivotTableOnNewSheet(); pivotTable.addPivotValue("columnName");
이 방법은 Looker 데이터 소스에만 사용할 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnName | String | 피벗 값의 기반이 되는 데이터 소스 열 이름입니다. |
리턴
PivotValue
- 새 피벗 값입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
지정된 요약이 있는 지정된 데이터 소스 열을 기반으로 새 피벗 값을 추가합니다. 함수를 사용하세요.
Looker 측정의 피벗 값을 추가하려면 addPivotValue(columnName)
를 사용하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnName | String | 피벗 값의 기반이 되는 데이터 소스 열 이름입니다. |
summarizeFunction | PivotTableSummarizeFunction | 피벗 값에서 사용하는 summarize 함수입니다. |
리턴
PivotValue
: 새 피벗 값입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addRowGroup(columnName)
지정된 데이터 소스 열을 기반으로 새 피벗 행 그룹을 추가합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnName | String | 피벗 그룹의 기반이 되는 데이터 소스 열 이름입니다. |
리턴
PivotGroup
- 새 피벗 그룹입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asPivotTable()
데이터 소스 피벗 테이블을 일반 피벗 테이블 객체로 반환합니다.
리턴
PivotTable
- 피벗 테이블입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
cancelDataRefresh()
현재 실행 중인 경우 이 객체와 관련된 데이터 새로고침을 취소합니다.
이 예에서는 수식 새로고침을 취소하는 방법을 보여줍니다.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution()
메서드를 사용하여 특정 데이터 소스의 데이터 실행을 사용 설정합니다.
있습니다.
리턴
DataSourcePivotTable
- 데이터 객체입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
현재 상태와 관계없이 이 객체의 데이터를 새로고침합니다. refreshData()
에서 다음을 확인하세요.
확인하세요. 이 객체의 현재 실행 중인 새로고침을 취소하려면 cancelDataRefresh()
를 참고하세요.
데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution()
메서드를 사용하여 특정 데이터 소스 유형의 데이터 실행을 사용 설정합니다.
리턴
DataSourcePivotTable
: 데이터 객체입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
객체가 연결된 데이터 소스를 가져옵니다.
리턴
DataSource
- 데이터 소스입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
객체의 데이터 실행 상태를 가져옵니다.
리턴
DataExecutionStatus
: 데이터 실행 상태입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
객체의 데이터를 새로고침합니다.
현재 error
상태인 경우 예외가 발생합니다. DataSource#updateSpec()
를 사용하여 사양을 업데이트합니다. 이 메서드는 데이터 소스의 예기치 않은 수정을 방지하기 위해 forceRefreshData()
보다 선호됩니다.
데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution()
메서드를 사용하여 특정 데이터 소스의 데이터 실행을 사용 설정합니다.
있습니다.
리턴
DataSourcePivotTable
- 데이터 객체입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
현재 실행이 완료될 때까지 대기하고, 제공된 시간(초)이 지나면 타임아웃됩니다. 시간 초과 시 실행이 완료되지 않으면 예외가 발생하지만 데이터 실행입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
timeoutInSeconds | Integer | 데이터 실행을 기다리는 시간(초)입니다. 최댓값은 300입니다. 초 단위입니다. |
리턴
DataExecutionStatus
- 데이터 실행 상태입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets