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 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 | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
cancelAllLinkedDataSourceObjectRefreshes() | void | Huỷ tất cả các lần 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 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 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 đã tính 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ả đố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 này bằng thông số kỹ thuật mới. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Cập nhật quy cách nguồn dữ liệu và làm mới data
source sheets đã liên kết bằng quy cách 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 được cung cấp. |
Tài liệu chi tiết
cancelAllLinkedDataSourceObjectRefreshes()
Huỷ tất cả các lần 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 của một nguồn dữ liệu.
SpreadsheetApp.enableBigQueryExecution(); const dataSource = spreadsheet.getDataSources()[0]; dataSource.cancelAllLinkedDataSourceObjectRefreshes();
Gửi một ngoại lệ nếu loại nguồn dữ liệu chưa đượ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 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 đã tính.
Thông số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên của cột đã tính. |
formula | String | Công thức của cột đã tính. |
Cầu thủ trả bóng
DataSourceColumn
— Cột được 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 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 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 trang tính mới. Ngoài ra, hãy đặt trang tính mới làm 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 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. Như một hiệu ứng phụ, hãy đặt trang tính mới làm trang tính đang hoạt động.
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 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 đã tính trong nguồn dữ liệu khớp với tên cột.
Thông số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnName | String | Tên của cột đã tính cần nhận. |
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 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 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á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 đã được tính 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 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á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 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ề 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 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 nguồn dữ liệu.
Cầu thủ trả bóng
DataSourceSpec
— Thông số kỹ thuật của 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 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.
Gửi một ngoại lệ nếu loại nguồn dữ liệu chưa đượ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 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 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 nguồn dữ liệu chưa đượ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ể.
Thông số
Tên | Loại | Nội dung mô tả |
---|---|---|
spec | DataSourceSpec | Thông số nguồn dữ liệu để 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 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 quy cách nguồn dữ liệu và làm mới data
source sheets
đã 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 chưa đượ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ể.
Thông số
Tên | Loại | Nội dung mô tả |
---|---|---|
spec | DataSourceSpec | Thông số nguồn dữ liệu để cập nhật. |
refreshAllLinkedObjects | Boolean | Nếu là true , hãy 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
Các tập lệnh sử dụng phương thức này yêu cầu 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 được 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 lượt thực thi dữ liệu.
Thông số
Tên | Loại | Nội dung 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 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