Class DataSource

Nguồndữ liệu

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ứcLoại dữ liệu trả vềMô tả ngắn
cancelAllLinkedDataSourceObjectRefreshes()voidHuỷ 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)DataSourceColumnTạo một cột được tính toán.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTableTạ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()DataSourceTableTạ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)DataSourceColumnTrả 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()DataSourceSpecLấy thông số kỹ thuật của nguồn dữ liệu.
refreshAllLinkedDataSourceObjects()voidLà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)DataSourceCậ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)DataSourceCậ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)voidChờ 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ênLoạiMô tả
nameStringTên của cột được tính.
formulaStringCô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ênLoạiMô tả
columnNameStringTê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.

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

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 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ể.

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ênLoạiMô tả
specDataSourceSpecThô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 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ể.

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ênLoạiMô tả
specDataSourceSpecThông số nguồn dữ liệu cần cập nhật.
refreshAllLinkedObjectsBooleanNế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ênLoạiMô tả
timeoutInSecondsIntegerThờ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