Class DataSource

取消所有目前正在執行的資料來源物件重新整理作業，這些物件已連結至這個資料來源。

本範例說明如何取消資料來源的所有重新整理作業。

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

建立計算結果欄。這個方法僅適用於 BigQuery 資料來源。

參數

回攻員

DataSourceColumn：新建立的計算結果欄。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

在新工作表的第一個儲存格中，根據這個資料來源建立資料來源資料透視表。並將新試算表設為活動試算表。

回攻員

DataSourcePivotTable：新建立的資料來源資料透視表。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

在新工作表的第一個儲存格中，根據這個資料來源建立資料來源表格。並將新試算表設為活動試算表。

這個方法僅適用於 BigQuery 資料來源。

回攻員

DataSourceTable：新建立的資料來源表格。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

傳回資料來源中與資料欄名稱相符的計算結果欄。

參數

回攻員

DataSourceColumn：與資料欄名稱相符的計算結果欄，如果沒有這樣的計算結果欄，則為 null。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

傳回資料來源中的所有計算欄。

DataSourceType.LOOKER 類型的資料來源規格會傳回空陣列。

回攻員

DataSourceColumn[]：資料來源中所有計算結果欄的陣列。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

傳回資料來源中的所有資料欄。

回攻員

DataSourceColumn[]：資料來源中所有 DataSourceColumn 的陣列。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

傳回與此資料來源相關聯的資料來源工作表。

回攻員

DataSourceSheet[]：資料來源工作表陣列。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

取得資料來源規格。

回攻員

DataSourceSpec：資料來源規格。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

重新整理連結至資料來源的所有資料來源物件。

如果未啟用資料來源類型，系統會擲回例外狀況。使用 SpreadsheetApp#enable...Execution() 方法，為特定資料來源類型啟用資料執行程序。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

更新資料來源規格，並使用新規格重新整理與此資料來源連結的資料來源物件。

如果未啟用資料來源類型，系統會擲回例外狀況。使用 SpreadsheetApp#enable...Execution() 方法，為特定資料來源類型啟用資料執行程序。

如果資料來源規格類型與目前的資料來源類型不同，就會擲回例外狀況。

參數

回攻員

DataSource：資料來源。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

更新資料來源規格，並使用新規格重新整理已連結的 data source sheets。

如果未啟用資料來源類型，系統會擲回例外狀況。使用 SpreadsheetApp#enable...Execution() 方法，為特定資料來源類型啟用資料執行程序。

如果資料來源規格類型與目前的資料來源類型不同，就會擲回例外狀況。

參數

回攻員

DataSource：資料來源。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

等待已連結資料來源物件的所有目前執行作業完成，並在提供的秒數後逾時。如果執行作業在逾時時未完成，則會擲回例外狀況，但不會取消資料執行作業。

參數

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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