Class DataSource

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ứcLoại dữ liệu trả vềMô tả ngắn
cancelAllLinkedDataSourceObjectRefreshes()voidHuỷ 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)DataSourceColumnTạo một cột đã tính.
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 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)DataSourceColumnTrả 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ề 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ả cá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ố kỹ thuật của 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)voidChờ 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ả 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 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. Phương pháp này chỉ áp dụng cho nguồn dữ liệu BigQuery.

Thông số

TênLoạiMô tả
nameStringTên của cột đã tính toán.
formulaStringCô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.

Phương pháp 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 được 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 đã tính toán trong nguồn dữ liệu khớp với tên cột.

Thông số

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

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

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

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ả cá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 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

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.

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 đối với dữ liệu cụ thể loại nguồn.

Gửi một ngoại lệ nếu loại thông số kỹ thuật nguồn dữ liệu thuộc loại khác với loại nguồn dữ liệu hiện tại.

Thông 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

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.

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.

Gửi một ngoại lệ nếu loại thông số kỹ thuật nguồn dữ liệu thuộc loại khác với loại nguồn dữ liệu hiện tại.

Thông số

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

Thông số

TênLoạiMô tả
timeoutInSecondsIntegerThờ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