此页面由 Cloud Translation API 翻译。

Class DataSource

访问和修改现有的数据源。如需创建具有新数据源的数据源表，请参阅 DataSourceTable。

此类只能用于连接到数据库的数据。

方法

方法	返回类型	简介
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	创建计算列。
`createDataSourcePivotTableOnNewSheet()`	`DataSourcePivotTable`	在新工作表的第一个单元格中根据此数据源创建数据源数据透视表。
`createDataSourceTableOnNewSheet()`	`DataSourceTable`	在新工作表的第一个单元格中根据此数据源创建数据源表格。
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	返回数据源中与列名称匹配的计算列。
`getCalculatedColumns()`	`DataSourceColumn[]`	返回数据源中的所有计算列。
`getColumns()`	`DataSourceColumn[]`	返回数据源中的所有列。
`getDataSourceSheets()`	`DataSourceSheet[]`	返回与此数据源关联的数据源工作表。
`getSpec()`	`DataSourceSpec`	获取数据源规范。
`refreshAllLinkedDataSourceObjects()`	`void`	刷新与数据源关联的所有数据源对象。
`updateSpec(spec)`	`DataSource`	更新数据源规范，并使用新规范刷新与此数据源关联的数据源对象。
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	更新数据源规范，并使用新的规范刷新关联的 `data source sheets`。
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	等待关联数据源对象当前执行的所有作业完成，并在提供的秒数后超时。

详细文档

`createCalculatedColumn(name, formula)`

创建计算列。

参数

名称	类型	说明
`name`	`String`	计算列的名称。
`formula`	`String`	计算列的公式。

DataSourceColumn - 新创建的计算列。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`createDataSourcePivotTableOnNewSheet()`

在新工作表的第一个单元格中根据此数据源创建数据源数据透视表。此操作的一个附带作用是将新工作表设为活动工作表。

DataSourcePivotTable - 新创建的数据源数据透视表。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`createDataSourceTableOnNewSheet()`

在新工作表的第一个单元格中根据此数据源创建数据源表格。副作用是将新工作表设为活动工作表。

DataSourceTable - 新创建的数据源表。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`getCalculatedColumnByName(columnName)`

返回数据源中与列名称匹配的计算列。

参数

名称	类型	说明
`columnName`	`String`	要获取的计算列名称。

DataSourceColumn - 与列名称匹配的计算列；如果没有这样的计算列，则返回 null。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`getCalculatedColumns()`

返回数据源中的所有计算列。

DataSourceColumn[] - 数据源中所有计算列的数组。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`getColumns()`

返回数据源中的所有列。

DataSourceColumn[] - 数据源中所有 DataSourceColumn 的数组。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`getDataSourceSheets()`

返回与此数据源关联的数据源工作表。

DataSourceSheet[] - 数据源工作表的数组。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`getSpec()`

获取数据源规范。

DataSourceSpec - 数据源规范。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`refreshAllLinkedDataSourceObjects()`

刷新与数据源关联的所有数据源对象。

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法为特定数据源类型启用数据执行功能。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`updateSpec(spec)`

更新数据源规范，并使用新规范刷新与此数据源关联的数据源对象。

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法为特定数据源类型启用数据执行功能。

参数

名称	类型	说明
`spec`	`DataSourceSpec`	要更新的数据源规范。

DataSource - 数据源。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`updateSpec(spec, refreshAllLinkedObjects)`

更新数据源规范，并使用新的规范刷新关联的 data source sheets。

如果数据源类型未启用，则会抛出异常。使用 SpreadsheetApp#enable...Execution() 方法为特定数据源类型启用数据执行功能。

参数

名称	类型	说明
`spec`	`DataSourceSpec`	要更新的数据源规范。
`refreshAllLinkedObjects`	`Boolean`	如果为 `true`，则还会刷新与此数据源关联的所有数据源对象。

DataSource - 数据源。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

等待关联数据源对象当前执行的所有作业完成，并在提供的秒数后超时。如果执行超时，但执行并未取消，则抛出异常。

参数

名称	类型	说明
`timeoutInSeconds`	`Integer`	等待数据执行的时间（以秒为单位）。最大值为 300 秒。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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