方法
內容詳盡的說明文件
build()
根據這個產生器的設定,建構資料來源規格。建構前必須使用 as...() 指定資料來源類型。
下列程式碼範例會建構 BigQuery DataSource Spec。
const bigQueryDataSourceSpec = SpreadsheetApp.newDataSourceSpec().asBigQuery(); // TODO(developer): Replace with the required dataset, project and table IDs. bigQueryDataSourceSpec.setDatasetId('my data set id'); bigQueryDataSourceSpec.setProjectId('my project id'); bigQueryDataSourceSpec.setTableId('my table id'); bigQueryDataSourceSpec.build();
下列程式碼範例會建構 Looker DataSource Spec。
const lookerDataSourceSpecBuilder = SpreadsheetApp.newDataSourceSpec().asLooker(); const lookerSpec = lookerDataSourceSpecBuilder.setExploreName('my explore name') .setInstanceUrl('my instance url') .setModelName('my model name') .build();
回攻員
DataSourceSpec:資料來源規格。
copy()
根據這個資料來源的設定建立 DataSourceSpecBuilder。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const newSpec = spec.copy();
回攻員
DataSourceSpecBuilder:建構工具。
getDatasetId()
取得 BigQuery 資料集 ID。
回攻員
String:資料集 ID,如果資料來源規格是由原始查詢定義,則為空字串。
getParameters()
取得資料來源的參數。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const parameters = spec.getParameters();
這個方法僅適用於 BigQuery 資料來源。
回攻員
DataSourceParameter[]:參數清單。
getProjectId()
取得報帳專案 ID。
回攻員
String:專案 ID。
getRawQuery()
取得原始查詢字串。
回攻員
String:原始查詢字串。
getTableId()
取得 BigQuery 資料表 ID。
回攻員
String:資料表 ID,如果資料來源規格是由原始查詢定義,則為空字串。
getTableProjectId()
取得資料表的 BigQuery 專案 ID。
回攻員
String:資料表專案 ID,如果資料來源規格是由原始查詢定義,則為空字串。
getType()
取得資料來源的類型。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const type = spec.getType();
回攻員
DataSourceType:資料來源類型。
removeAllParameters()
移除所有參數。
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeAllParameters();
回攻員
BigQueryDataSourceSpecBuilder - 鏈結的建構工具。
removeParameter(parameterName)
移除指定參數。
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeParameter('x');
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
parameter | String | 要移除的參數名稱。 |
回攻員
BigQueryDataSourceSpecBuilder - 鏈結的建構工具。
setDatasetId(datasetId)
setParameterFromCell(parameterName, sourceCell)
新增參數,或更新類型為 DataSourceType.BIGQUERY 的資料來源規格建構工具的來源儲存格 (如果參數名稱已存在)。
這個方法僅適用於 BigQuery 資料來源。
const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery(); specBuilder.setParameterFromCell('x', 'A1'); const bigQuerySpec = specBuilder.build();
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
parameter | String | 參數名稱。 |
source | String | 來源儲存格,以 A1 標記法指定。 |
回攻員
BigQueryDataSourceSpecBuilder - 鏈結的建構工具。
setProjectId(projectId)
設定帳單 BigQuery 專案 ID。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
project | String | 報帳專案的 ID。 |
回攻員
BigQueryDataSourceSpecBuilder - 鏈結的建構工具。
setRawQuery(rawQuery)
setTableId(tableId)
setTableProjectId(projectId)
設定資料表的 BigQuery 專案 ID。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
project | String | BigQuery 資料表的專案 ID。 |
回攻員
BigQueryDataSourceSpecBuilder - 鏈結的建構工具。