Class DataSource

DataSource

기존 데이터 소스에 액세스하고 수정합니다. 새 데이터 소스로 데이터 소스 테이블을 만들려면 DataSourceTable을 참고하세요.

데이터베이스에 연결된 데이터에만 이 클래스를 사용합니다.

방법

메서드반환 유형간략한 설명
createCalculatedColumn(name, formula)DataSourceColumn계산된 열을 만듭니다.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTable새 시트의 첫 번째 셀에 이 데이터 소스에서 데이터 소스 피벗 테이블을 만듭니다.
createDataSourceTableOnNewSheet()DataSourceTable새 시트의 첫 번째 셀에 이 데이터 소스에서 데이터 소스 테이블을 만듭니다.
getCalculatedColumnByName(columnName)DataSourceColumn데이터 소스에서 열 이름과 일치하는 계산된 열을 반환합니다.
getCalculatedColumns()DataSourceColumn[]데이터 소스의 계산된 열을 모두 반환합니다.
getColumns()DataSourceColumn[]데이터 소스의 모든 열을 반환합니다.
getDataSourceSheets()DataSourceSheet[]이 데이터 소스와 연결된 데이터 소스 시트를 반환합니다.
getSpec()DataSourceSpec데이터 소스 사양을 가져옵니다.
refreshAllLinkedDataSourceObjects()void데이터 소스에 연결된 모든 데이터 소스 객체를 새로고침합니다.
updateSpec(spec)DataSource데이터 소스 사양을 업데이트하고 이 데이터 소스와 연결된 데이터 소스 객체를 새 사양으로 새로고침합니다.
updateSpec(spec, refreshAllLinkedObjects)DataSource데이터 소스 사양을 업데이트하고 연결된 data source sheets를 새 사양으로 새로고침합니다.
waitForAllDataExecutionsCompletion(timeoutInSeconds)void연결된 데이터 소스 객체의 현재 실행이 모두 완료될 때까지 대기하며 지정된 시간(초)이 지나면 타임아웃됩니다.

자세한 문서

createCalculatedColumn(name, formula)

계산된 열을 만듭니다.

매개변수

이름유형설명
nameString계산된 열의 이름입니다.
formulaString계산된 열 수식입니다.

리턴

DataSourceColumn - 새로 생성된 계산된 열입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

createDataSourcePivotTableOnNewSheet()

새 시트의 첫 번째 셀에 이 데이터 소스에서 데이터 소스 피벗 테이블을 만듭니다. 부작용으로 새 시트를 활성 시트로 만듭니다.

리턴

DataSourcePivotTable - 새로 생성된 데이터 소스 피벗 테이블입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

createDataSourceTableOnNewSheet()

새 시트의 첫 번째 셀에 이 데이터 소스에서 데이터 소스 테이블을 만듭니다. 부작용으로 새 시트를 활성 시트로 만듭니다.

리턴

DataSourceTable - 새로 만든 데이터 소스 테이블입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getCalculatedColumnByName(columnName)

데이터 소스에서 열 이름과 일치하는 계산된 열을 반환합니다.

매개변수

이름유형설명
columnNameString가져올 계산된 열의 이름입니다.

리턴

DataSourceColumn - 열 이름과 일치하는 계산된 열 또는 계산된 열이 없는 경우 null입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getCalculatedColumns()

데이터 소스의 계산된 열을 모두 반환합니다.

리턴

DataSourceColumn[] - 데이터 소스의 계산된 모든 열의 배열입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getColumns()

데이터 소스의 모든 열을 반환합니다.

리턴

DataSourceColumn[] - 데이터 소스에 있는 모든 DataSourceColumn의 배열입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getDataSourceSheets()

이 데이터 소스와 연결된 데이터 소스 시트를 반환합니다.

리턴

DataSourceSheet[] - 데이터 소스 시트의 배열입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getSpec()

데이터 소스 사양을 가져옵니다.

리턴

DataSourceSpec - 데이터 소스 사양입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

refreshAllLinkedDataSourceObjects()

데이터 소스에 연결된 모든 데이터 소스 객체를 새로고침합니다.

데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution() 메서드를 사용하여 특정 데이터 소스 유형에 대한 데이터 실행을 사용 설정합니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

updateSpec(spec)

데이터 소스 사양을 업데이트하고 이 데이터 소스와 연결된 데이터 소스 객체를 새 사양으로 새로고침합니다.

데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution() 메서드를 사용하여 특정 데이터 소스 유형에 대한 데이터 실행을 사용 설정합니다.

매개변수

이름유형설명
specDataSourceSpec업데이트할 데이터 소스 사양입니다.

리턴

DataSource - 데이터 소스입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

updateSpec(spec, refreshAllLinkedObjects)

데이터 소스 사양을 업데이트하고 연결된 data source sheets를 새 사양으로 새로고침합니다.

데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution() 메서드를 사용하여 특정 데이터 소스 유형에 대한 데이터 실행을 사용 설정합니다.

매개변수

이름유형설명
specDataSourceSpec업데이트할 데이터 소스 사양입니다.
refreshAllLinkedObjectsBooleantrue이면 이 데이터 소스와 연결된 모든 데이터 소스 객체도 새로고침합니다.

리턴

DataSource - 데이터 소스입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

waitForAllDataExecutionsCompletion(timeoutInSeconds)

연결된 데이터 소스 객체의 현재 실행이 모두 완료될 때까지 대기하며 지정된 시간(초)이 지나면 타임아웃됩니다. 제한 시간 초과 시 실행이 완료되지 않으면 예외가 발생하지만 데이터 실행이 취소되지는 않습니다.

매개변수

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

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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