Class DataSource

DataSource

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

이 클래스는 데이터베이스에 연결된 데이터에만 사용하세요.

메서드

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

자세한 문서

cancelAllLinkedDataSourceObjectRefreshes()

이 데이터 소스에 연결된 데이터 소스 객체의 현재 실행 중인 모든 새로고침을 취소합니다.

이 예시에서는 데이터 소스의 모든 새로고침을 취소하는 방법을 보여줍니다. 

SpreadsheetApp.enableBigQueryExecution();
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

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

승인

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

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

createCalculatedColumn(name, formula)

계산된 열을 만듭니다. 이 메서드는 BigQuery 데이터 소스에만 사용할 수 있습니다.

매개변수

이름유형설명
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()

새 시트의 첫 번째 셀에 이 데이터 소스로부터 데이터 소스 표를 만듭니다. 부작용으로 새 시트가 활성 시트가 됩니다.

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

리턴

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

승인

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

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

getCalculatedColumnByName(columnName)

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

매개변수

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

리턴

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

승인

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

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

getCalculatedColumns()

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

DataSourceType.LOOKER 유형의 데이터 소스 사양은 빈 배열을 반환합니다.

리턴

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