Trang này được dịch bởi Cloud Translation API.

Class DataSource

Truy cập và sửa đổi nguồn dữ liệu hiện có. Để tạo một bảng nguồn dữ liệu có nguồn dữ liệu mới, hãy xem DataSourceTable.

Chỉ sử dụng lớp này với dữ liệu được kết nối với cơ sở dữ liệu.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`cancelAllLinkedDataSourceObjectRefreshes()`	`void`	Huỷ tất cả quá trình làm mới đang chạy của đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu này.
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	Tạo một cột đã tính.
`createDataSourcePivotTableOnNewSheet()`	`DataSourcePivotTable`	Tạo một bảng tổng hợp nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của một trang tính mới.
`createDataSourceTableOnNewSheet()`	`DataSourceTable`	Tạo một bảng nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của một trang tính mới.
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	Trả về cột đã tính toán trong nguồn dữ liệu khớp với tên cột.
`getCalculatedColumns()`	`DataSourceColumn[]`	Trả về tất cả các cột đã tính trong nguồn dữ liệu.
`getColumns()`	`DataSourceColumn[]`	Trả về tất cả các cột trong nguồn dữ liệu.
`getDataSourceSheets()`	`DataSourceSheet[]`	Trả về trang tính nguồn dữ liệu được liên kết với nguồn dữ liệu này.
`getSpec()`	`DataSourceSpec`	Lấy thông số kỹ thuật nguồn dữ liệu.
`refreshAllLinkedDataSourceObjects()`	`void`	Làm mới tất cả các đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu.
`updateSpec(spec)`	`DataSource`	Cập nhật thông số kỹ thuật nguồn dữ liệu và làm mới các đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu với thông số kỹ thuật mới.
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	Cập nhật thông số kỹ thuật nguồn dữ liệu và làm mới `data source sheets` được liên kết bằng thông số kỹ thuật mới.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Chờ cho đến khi tất cả các quá trình thực thi hiện tại của đối tượng nguồn dữ liệu được liên kết hoàn tất, hết thời gian chờ sau số giây đã cho.

Tài liệu chi tiết

`cancelAllLinkedDataSourceObjectRefreshes()`

Huỷ tất cả quá trình làm mới đang chạy của đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu này.

Ví dụ này cho biết cách huỷ tất cả các lần làm mới một nguồn dữ liệu.

SpreadsheetApp.enableBigQueryExecution();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

Gửi một trường hợp ngoại lệ nếu loại nguồn dữ liệu không được bật. Sử dụng các phương thức SpreadsheetApp#enable...Execution() để cho phép thực thi dữ liệu đối với dữ liệu cụ thể loại nguồn.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`createCalculatedColumn(name, formula)`

Tạo một cột đã tính.

Tham số

Tên	Loại	Mô tả
`name`	`String`	Tên của cột đã tính toán.
`formula`	`String`	Công thức của cột đã tính toán.

Cầu thủ trả bóng

DataSourceColumn – Cột được tính mới được tạo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`createDataSourcePivotTableOnNewSheet()`

Tạo một bảng tổng hợp nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của một trang tính mới. Là một hiệu ứng phụ, đặt trang tính mới làm trang tính hiện hoạt.

Cầu thủ trả bóng

DataSourcePivotTable — Bảng tổng hợp nguồn dữ liệu mới tạo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`createDataSourceTableOnNewSheet()`

Tạo một bảng nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của một trang tính mới. Ở một bên sẽ đặt trang tính mới làm trang tính hiện hoạt.

Cầu thủ trả bóng

DataSourceTable – Bảng nguồn dữ liệu mới được tạo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`getCalculatedColumnByName(columnName)`

Trả về cột đã tính toán trong nguồn dữ liệu khớp với tên cột.

Tham số

Tên	Loại	Mô tả
`columnName`	`String`	Tên của cột đã tính toán cần lấy.

Cầu thủ trả bóng

DataSourceColumn – Cột đã tính toán khớp với tên cột hoặc null nếu không có cột nào như vậy cột đã tính.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`getCalculatedColumns()`

Trả về tất cả các cột đã tính trong nguồn dữ liệu.

Cầu thủ trả bóng

DataSourceColumn[] – Một mảng gồm tất cả các cột đã tính toán trong nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`getColumns()`

Trả về tất cả các cột trong nguồn dữ liệu.

Cầu thủ trả bóng

DataSourceColumn[] – Một mảng gồm tất cả DataSourceColumn trong nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`getDataSourceSheets()`

Trả về trang tính nguồn dữ liệu được liên kết với nguồn dữ liệu này.

Cầu thủ trả bóng

DataSourceSheet[] – Một mảng trang tính nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`getSpec()`

Lấy thông số kỹ thuật nguồn dữ liệu.

Cầu thủ trả bóng

DataSourceSpec – Thông số kỹ thuật nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`refreshAllLinkedDataSourceObjects()`

Làm mới tất cả các đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`updateSpec(spec)`

Cập nhật thông số kỹ thuật nguồn dữ liệu và làm mới các đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu với thông số kỹ thuật mới.

Tham số

Tên	Loại	Mô tả
`spec`	`DataSourceSpec`	Thông số nguồn dữ liệu cần cập nhật.

Cầu thủ trả bóng

DataSource — Nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`updateSpec(spec, refreshAllLinkedObjects)`

Cập nhật thông số kỹ thuật nguồn dữ liệu và làm mới data source sheets được liên kết bằng thông số kỹ thuật mới.

Tham số

Tên	Loại	Mô tả
`spec`	`DataSourceSpec`	Thông số nguồn dữ liệu cần cập nhật.
`refreshAllLinkedObjects`	`Boolean`	Nếu là `true`, cũng làm mới tất cả đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu này.

Cầu thủ trả bóng

DataSource — Nguồn dữ liệu.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Chờ cho đến khi tất cả các quá trình thực thi hiện tại của đối tượng nguồn dữ liệu được liên kết hoàn tất, hết thời gian chờ sau số giây đã cho. Gửi một ngoại lệ nếu quá trình thực thi chưa hoàn tất khi hết thời gian chờ, nhưng không huỷ quá trình thực thi dữ liệu.

Tham số

Tên	Loại	Mô tả
`timeoutInSeconds`	`Integer`	Thời gian để chờ thực thi dữ liệu, tính bằng giây. Tối đa là 300 giây.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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