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 bảng nguồn dữ liệu có nguồn dữ liệu mới, hãy xem phần 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ả các lần làm mới đối tượng nguồn dữ liệu đang chạy được liên kết với nguồn dữ liệu này.
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	Tạo một cột được tính toán.
`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 bảng nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của trang tính mới.
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	Trả về cột được 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ột được tính toán trong nguồn dữ liệu.
`getColumns()`	`DataSourceColumn[]`	Trả về tất cả cột trong nguồn dữ liệu.
`getDataSourceSheets()`	`DataSourceSheet[]`	Trả về các 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 của nguồn dữ liệu.
`refreshAllLinkedDataSourceObjects()`	`void`	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.
`updateSpec(spec)`	`DataSource`	Cập nhật thông số kỹ thuật của 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 này bằng thông số kỹ thuật mới.
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	Cập nhật thông số nguồn dữ liệu và làm mới `data source sheets` được liên kết bằng thông số mới.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Chờ cho đến khi tất cả các lần 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 đã cung cấp.

Tài liệu chi tiết

`cancelAllLinkedDataSourceObjectRefreshes()`

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

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

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

Gửi một 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 cho loại nguồn dữ liệu cụ thể.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 được tính toán. Phương thức này chỉ áp dụng cho nguồn dữ liệu BigQuery.

Tham số

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

Cầu thủ trả bóng

DataSourceColumn – Cột đã tính mới tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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. Hiệu ứng phụ là làm cho trang tính mới trở thành trang tính đang hoạt động.

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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 bảng nguồn dữ liệu từ nguồn dữ liệu này trong ô đầu tiên của trang tính mới. Hiệu ứng phụ là đặt trang tính mới làm trang tính đang hoạt động.

Phương thức này chỉ áp dụng cho nguồn dữ liệu BigQuery.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 được 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 được tính toán cần lấy.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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ột được tính toán trong nguồn dữ liệu.

Thông số nguồn dữ liệu thuộc loại DataSourceType.LOOKER sẽ trả về một mảng trống.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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ộ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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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ề các 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 gồm các trang tính nguồn dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 của nguồn dữ liệu.

Cầu thủ trả bóng

DataSourceSpec – Thông số nguồn dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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ả đối tượng nguồn dữ liệu được liên kết với nguồn dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 của 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 này bằng thông số kỹ thuật mới.

Gửi một ngoại lệ nếu loại thông số nguồn dữ liệu khác với loại nguồn dữ liệu hiện tạ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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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ố nguồn dữ liệu và làm mới data source sheets được liên kết bằng thông số mới.

Gửi một ngoại lệ nếu loại thông số nguồn dữ liệu khác với loại nguồn dữ liệu hiện tạ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 `true`, cũng 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 này.

Cầu thủ trả bóng

DataSource – Nguồn dữ liệu.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 lần 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 đã cung cấp. Gửi một ngoại lệ nếu quá trình thực thi không hoàn tất khi hết thời gian chờ, nhưng không huỷ các 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. Thời lượng tối đa là 300 giây.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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