Class DataSourceFormula

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()를 참고하세요.

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

리턴

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

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

리턴

DataSourceFormula — 데이터 객체입니다.

승인

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

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

setFormula(formula)

수식을 업데이트합니다.

매개변수

이름유형설명
formulaString새 수식입니다.

리턴

DataSourceFormula — 연결을 위한 데이터 소스 수식입니다.

승인

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

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

waitForCompletion(timeoutInSeconds)

현재 실행이 완료될 때까지 기다리며 제공된 초 후에 시간 초과됩니다. 시간 초과 시 실행이 완료되지 않으면 예외가 발생하지만 데이터 실행은 취소되지 않습니다.

매개변수

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

리턴

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

승인

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

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