Class DataSourceSpec

DataSourceSpec

存取現有資料來源規格的一般設定。如要存取特定類型的資料來源規格,請使用 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()

取得 BigQuery 資料來源的規格。

回攻員

BigQueryDataSourceSpec:BigQuery 資料來源規格。


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:資料來源類型。