Class DataSourcePivotTable

데이터소스피벗테이블

기존 데이터 소스 피벗 테이블에 액세스하고 수정합니다. 새 데이터 소스 피벗 테이블을 만들려면 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)

지정된 데이터 소스 열을 기반으로 새 피벗 열 그룹을 추가합니다.

매개변수

이름유형설명
columnNameString피벗 그룹의 기반이 되는 데이터 소스 열 이름입니다.

리턴

PivotGroup: 새 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addFilter(columnName, filterCriteria)

지정된 필터 기준을 사용하여 지정된 데이터 소스 열을 기반으로 새 필터를 추가합니다.

매개변수

이름유형설명
columnNameString필터가 기반으로 하는 데이터 소스 열 이름입니다.
filterCriteriaFilterCriteria필터에서 사용하는 기준입니다.

리턴

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.
const spreadsheet = SpreadsheetApp.openById('abcd1234');
const datasource = spreadsheet.getDataSources()[0];
const pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue('columnName');

이 메서드는 Looker 데이터 소스에만 사용할 수 있습니다.

매개변수

이름유형설명
columnNameString피벗 값의 기반이 되는 데이터 소스 열 이름입니다.

리턴

PivotValue: 새 피벗 값입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addPivotValue(columnName, summarizeFunction)

지정된 요약 함수와 함께 지정된 데이터 소스 열을 기반으로 새 피벗 값을 추가합니다.

Looker 측정항목의 피벗 값을 추가하려면 addPivotValue(columnName)를 사용합니다.

매개변수

이름유형설명
columnNameString피벗 값의 기반이 되는 데이터 소스 열 이름입니다.
summarizeFunctionPivotTableSummarizeFunction피벗 값에서 사용하는 summarize 함수입니다.

리턴

PivotValue: 새 피벗 값입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addRowGroup(columnName)

지정된 데이터 소스 열을 기반으로 새 피벗 행 그룹을 추가합니다.

매개변수

이름유형설명
columnNameString피벗 그룹의 기반이 되는 데이터 소스 열 이름입니다.

리턴

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)

현재 실행이 완료될 때까지 대기하고 지정된 시간(초)이 지나면 시간 초과됩니다. 제한 시간 초과 시 실행이 완료되지 않은 경우 예외를 발생시키지만 데이터 실행을 취소하지는 않습니다.

매개변수

이름유형설명
timeoutInSecondsInteger데이터 실행을 기다리는 시간(초)입니다. 최댓값은 300초입니다.

리턴

DataExecutionStatus: 데이터 실행 상태입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets