存取現有資料來源規格的一般設定。如要存取特定類型的資料來源規格,請使用 as...()
方法。如要建立新的資料來源規格,請使用 SpreadsheetApp.newDataSourceSpec()
。
「這個類別」只能搭配連結至資料庫的資料使用。
本例說明如何從 BigQuery 資料來源規格取得資訊。
var dataSourceTable = SpreadsheetApp.getActive().getSheetByName("Data Sheet 1").getDataSourceTables()[0]; var spec = dataSourceTable.getDataSource().getSpec(); if (spec.getType() == SpreadsheetApp.DataSourceType.BIGQUERY) { var bqSpec = spec.asBigQuery(); Logger.log("Project ID: %s\n", bqSpec.getProjectId()); Logger.log("Raw query string: %s\n", bqSpec.getRawQuery()); }
本例說明如何從 Looker 資料來源規格取得資訊。使用 asLooker()
會傳回 LookerDataSourceSpec
物件。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); var spec = ss.getDataSources()[0].getSpec().asLooker(); if (spec.getType() == SpreadsheetApp.DataSourceType.LOOKER) { var lookerSpec = spec.asLooker(); Logger.log("Looker instance URL: %s\n", lookerSpec.getInstanceUrl()); }
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
asBigQuery() | BigQueryDataSourceSpec | 取得 BigQuery 資料來源的規格。 |
asLooker() | LookerDataSourceSpec | 取得 Looker 資料來源的規格。 |
copy() | DataSourceSpecBuilder | 根據這個資料來源的設定建立 DataSourceSpecBuilder 。 |
getParameters() | DataSourceParameter[] | 取得資料來源的參數。 |
getType() | DataSourceType | 取得資料來源的類型。 |
內容詳盡的說明文件
asBigQuery()
asLooker()
取得 Looker 資料來源的規格。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); var spec = ss.getDataSources()[0].getSpec().asLooker();
回攻員
LookerDataSourceSpec
:Looker 資料來源規格。
copy()
根據這個資料來源的設定建立 DataSourceSpecBuilder
。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); var spec = ss.getDataSources()[0].getSpec(); var newSpec = spec.copy();
回攻員
DataSourceSpecBuilder
:建構工具。
getParameters()
取得資料來源的參數。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); var spec = ss.getDataSources()[0].getSpec(); var parameters = spec.getParameters();
這個方法僅適用於 BigQuery 資料來源。
回攻員
DataSourceParameter[]
:參數清單。
getType()
取得資料來源的類型。
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); var spec = ss.getDataSources()[0].getSpec(); var type = spec.getType();
回攻員
DataSourceType
:資料來源類型。