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 bằng nguồn dữ liệu mới, hãy xem phần Data.
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 | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
cancel | void | Huỷ tất cả các hoạt động 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. |
create | Data | Tạo một cột đã tính. |
create | Data | Tạo 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. |
create | Data | 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. |
get | Data | Trả về cột được tính trong nguồn dữ liệu khớp với tên cột. |
get | Data | Trả về tất cả các cột được tính toán trong nguồn dữ liệu. |
get | Data | Trả về tất cả các cột trong nguồn dữ liệu. |
get | Data | Trả về các trang nguồn dữ liệu được liên kết với nguồn dữ liệu này. |
get | Data | Lấy quy cách nguồn dữ liệu. |
refresh | 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. |
update | Data | Cập nhật quy cách 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 quy cách mới. |
update | Data | Cập nhật quy cách nguồn dữ liệu và làm mới data
source sheets được liên kết bằng quy cách mới. |
wait | void | Chờ cho đến khi tất cả các lượt thực thi hiện tại của các đố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
cancel All Linked Data Source Object Refreshes()
Huỷ tất cả các hoạt động 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 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 Spreadsheet để 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
create Calculated Column(name, formula)
Tạo một cột đã tính. Phương thức này chỉ áp dụng cho nguồn dữ liệu BigQuery.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
name | String | Tên của cột đã tính. |
formula | String | Công thức cột đã tính. |
Cầu thủ trả bóng
Data – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
create Data Source Pivot Table On New Sheet()
Tạo 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 tác dụng phụ, thao tác này sẽ đặt trang tính mới làm trang tính đang hoạt động.
Cầu thủ trả bóng
Data – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
create Data Source Table On New Sheet()
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. Là một hiệu ứng phụ, hãy tạo trang tính mới thành 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
Data – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Calculated Column By Name(columnName)
Trả về cột được tính trong nguồn dữ liệu khớp với tên cột.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
column | String | Tên của cột đã tính cần lấy. |
Cầu thủ trả bóng
Data – Cột đã tính toán khớp với tên cột hoặc null nếu không có cột đã tính toán nào như vậy.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Calculated Columns()
Trả về tất cả cá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 Data sẽ trả về một mảng trống.
Cầu thủ trả bóng
Data – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Columns()
Trả về tất cả các cột trong nguồn dữ liệu.
Cầu thủ trả bóng
Data – Một mảng gồm tất cả Data trong nguồn dữ liệu.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Data Source Sheets()
Trả về các trang 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
Data – Một mảng các trang nguồn dữ liệu.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Spec()
Lấy quy cách nguồn dữ liệu.
Cầu thủ trả bóng
Data – Quy cách nguồn dữ liệu.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
refresh All Linked Data Source Objects()
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.
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 Spreadsheet để 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
update Spec(spec)
Cập nhật quy cách 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 quy cách mới.
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 Spreadsheet để cho phép thực thi dữ liệu cho loại nguồn dữ liệu cụ thể.
Gây ra một ngoại lệ nếu loại thông số nguồn dữ liệu thuộc một loại khác với loại nguồn dữ liệu hiện tại.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
spec | Data | Quy cách nguồn dữ liệu cần cập nhật. |
Cầu thủ trả bóng
Data – Nguồn dữ liệu.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
update Spec(spec, refreshAllLinkedObjects)
Cập nhật quy cách nguồn dữ liệu và làm mới data
source sheets được liên kết bằng quy cách mới.
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 Spreadsheet để cho phép thực thi dữ liệu cho loại nguồn dữ liệu cụ thể.
Gây ra một ngoại lệ nếu loại thông số nguồn dữ liệu thuộc một loại khác với loại nguồn dữ liệu hiện tại.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
spec | Data | Quy cách nguồn dữ liệu cần cập nhật. |
refresh | 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
Data – Nguồn dữ liệu.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
wait For All Data Executions Completion(timeoutInSeconds)
Chờ cho đến khi tất cả các lượt thực thi hiện tại của các đố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 các hoạt động thực thi chưa hoàn tất khi hết thời gian chờ, nhưng không huỷ các hoạt động thực thi dữ liệu.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
timeout | 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets