기존 데이터 소스에 액세스하고 수정합니다. 새 데이터 소스로 데이터 소스 테이블을 만들려면 DataSourceTable
를 참조하세요.
데이터베이스에 연결된 데이터에만 이 클래스를 사용합니다.
메서드
자세한 문서
cancelAllLinkedDataSourceObjectRefreshes()
이 데이터 소스에 연결된 데이터 소스 객체의 현재 실행 중인 모든 새로고침을 취소합니다.
이 예에서는 데이터 소스의 모든 새로고침을 취소하는 방법을 보여줍니다.
SpreadsheetApp.enableBigQueryExecution(); 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)
계산된 열을 만듭니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 계산된 열의 이름입니다. |
formula | String | 계산된 열 수식입니다. |
리턴
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)
데이터 소스에서 열 이름과 일치하는 계산된 열을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnName | String | 가져올 계산된 열의 이름입니다. |
리턴
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()
메서드를 사용하여 특정 데이터 소스 유형에 대한 데이터 실행을 사용 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
spec | DataSourceSpec | 업데이트할 데이터 소스 사양입니다. |
리턴
DataSource
- 데이터 소스입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 인증이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec, refreshAllLinkedObjects)
데이터 소스 사양을 업데이트하고 연결된 data
source sheets
를 새 사양으로 새로고침합니다.
데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution()
메서드를 사용하여 특정 데이터 소스 유형에 대한 데이터 실행을 사용 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
spec | DataSourceSpec | 업데이트할 데이터 소스 사양입니다. |
refreshAllLinkedObjects | Boolean | true 이면 이 데이터 소스와 연결된 모든 데이터 소스 객체도 새로고침합니다. |
리턴
DataSource
- 데이터 소스입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 인증이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
연결된 데이터 소스 객체의 현재 실행이 모두 완료될 때까지 대기하며, 지정된 시간(초) 후에 타임아웃됩니다. 시간 초과 시 실행이 완료되지 않지만 데이터 실행이 취소되지 않으면 예외가 발생합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
timeoutInSeconds | Integer | 데이터 실행을 기다리는 시간(초)입니다. 최댓값은 300초입니다. |
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 인증이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets