이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class DataSource

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

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

메서드

메서드	반환 유형	간략한 설명
`cancelAllLinkedDataSourceObjectRefreshes()`	`void`	이 데이터 소스에 연결된 데이터 소스 객체의 현재 실행 중인 모든 새로고침을 취소합니다.
`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`	연결된 데이터 소스 객체의 현재 실행이 모두 완료되어 타임아웃될 때까지 기다립니다. 지정된 시간(초) 후에 시작됩니다.

자세한 문서

`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)`

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

매개변수

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

새 시트의 첫 번째 셀에 있는 이 데이터 소스에서 데이터 소스 표를 만듭니다. 부수적인 효과로 새 시트를 활성 시트로 만듭니다.

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

리턴

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()`

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

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)`

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

데이터 소스 사양 유형이 현재 데이터 소스 유형입니다.

매개변수

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

리턴

DataSource - 데이터 소스입니다.

승인

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

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

`updateSpec(spec, refreshAllLinkedObjects)`

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

데이터 소스 사양 유형이 현재 데이터 소스 유형입니다.

매개변수

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