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

Class DataSourceFormula

기존 데이터 소스 수식에 액세스하고 수정합니다. 새 데이터 소스 수식을 만들려면 Range.setFormula(formula)를 사용합니다.

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

메서드

메서드	반환 유형	간략한 설명
`cancelDataRefresh()`	`DataSourceFormula`	현재 실행 중인 경우 이 객체와 연결된 데이터 새로고침을 취소합니다.
`forceRefreshData()`	`DataSourceFormula`	현재 상태와 관계없이 이 객체의 데이터를 새로고침합니다.
`getAnchorCell()`	`Range`	이 데이터 소스 수식이 고정된 셀을 나타내는 `Range`를 반환합니다.
`getDataSource()`	`DataSource`	객체가 연결된 데이터 소스를 가져옵니다.
`getDisplayValue()`	`String`	데이터 소스 수식의 표시 값을 반환합니다.
`getFormula()`	`String`	이 데이터 소스 수식의 수식을 반환합니다.
`getStatus()`	`DataExecutionStatus`	객체의 데이터 실행 상태를 가져옵니다.
`refreshData()`	`DataSourceFormula`	객체의 데이터를 새로고침합니다.
`setFormula(formula)`	`DataSourceFormula`	수식을 업데이트합니다.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	현재 실행이 완료될 때까지 대기하고 지정된 시간(초)이 지나면 시간 초과됩니다.

자세한 문서

`cancelDataRefresh()`

현재 실행 중인 경우 이 객체와 연결된 데이터 새로고침을 취소합니다.

이 예에서는 수식 새로고침을 취소하는 방법을 보여줍니다.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

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

리턴

DataSourceFormula: 데이터 객체입니다.

승인

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

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

`forceRefreshData()`

현재 상태와 관계없이 이 객체의 데이터를 새로고침합니다. 자세한 내용은 refreshData()를 참고하세요. 현재 실행 중인 이 객체의 새로고침을 취소하려면 cancelDataRefresh()를 참고하세요.

리턴

DataSourceFormula: 데이터 객체입니다.

승인

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

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

`getAnchorCell()`

이 데이터 소스 수식이 고정된 셀을 나타내는 Range를 반환합니다.

리턴

Range - 앵커 셀입니다.

승인

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

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

`getDisplayValue()`

데이터 소스 수식의 표시 값을 반환합니다.

리턴

String: 표시 값입니다.

승인

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

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

`getFormula()`

이 데이터 소스 수식의 수식을 반환합니다.

리턴

String - 수식입니다.

승인

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

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()보다 선호됩니다.

리턴

DataSourceFormula: 데이터 객체입니다.

승인

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

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

`setFormula(formula)`

수식을 업데이트합니다.

매개변수

이름	유형	설명
`formula`	`String`	새 수식입니다.

리턴

DataSourceFormula: 체이닝을 위한 데이터 소스 수식입니다.

승인

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

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

`waitForCompletion(timeoutInSeconds)`

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

매개변수

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

리턴

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

승인

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

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