Class DataSourcePivotTable

DataSourcePivotTable

Truy cập và sửa đổi bảng tổng hợp nguồn dữ liệu hiện có. Để tạo bảng tổng hợp nguồn dữ liệu mới, hãy sử dụng Range.createDataSourcePivotTable(dataSource).

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ứcKiểu dữ liệu trả vềMô tả ngắn
addColumnGroup(columnName)PivotGroupThêm một nhóm cột tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định.
addFilter(columnName, filterCriteria)PivotFilterThêm một bộ lọc mới dựa trên cột nguồn dữ liệu đã chỉ định với tiêu chí lọc đã chỉ định.
addPivotValue(columnName)PivotValueThêm một giá trị trục mới dựa trên cột nguồn dữ liệu đã chỉ định mà không có bất kỳ hàm tổng hợp nào.
addPivotValue(columnName, summarizeFunction)PivotValueThêm một giá trị trục mới dựa trên cột nguồn dữ liệu đã chỉ định bằng hàm tóm tắt đã chỉ định.
addRowGroup(columnName)PivotGroupThêm một nhóm hàng mới trong bảng tổng hợp dựa trên cột nguồn dữ liệu được chỉ định.
asPivotTable()PivotTableTrả về bảng tổng hợp nguồn dữ liệu dưới dạng một đối tượng bảng tổng hợp thông thường.
cancelDataRefresh()DataSourcePivotTableHuỷ quá trình làm mới dữ liệu liên kết với đối tượng này nếu quá trình đó đang chạy.
forceRefreshData()DataSourcePivotTableLàm mới dữ liệu của đối tượng này bất kể trạng thái hiện tại.
getDataSource()DataSourceLấy nguồn dữ liệu mà đối tượng được liên kết.
getStatus()DataExecutionStatusLấy trạng thái thực thi dữ liệu của đối tượng.
refreshData()DataSourcePivotTableLàm mới dữ liệu của đối tượng.
waitForCompletion(timeoutInSeconds)DataExecutionStatusĐợi cho đến khi quá trình thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây đã cung cấp.

Tài liệu chi tiết

addColumnGroup(columnName)

Thêm một nhóm cột tổng hợp mới dựa trên cột nguồn dữ liệu được chỉ định.

Tham số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà nhóm tổng hợp dựa vào.

Cầu thủ trả bóng

PivotGroup – Nhóm tổng hợp mới.

Ủ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

addFilter(columnName, filterCriteria)

Thêm một bộ lọc mới dựa trên cột nguồn dữ liệu đã chỉ định với tiêu chí lọc đã chỉ định.

Tham số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà bộ lọc dựa vào.
filterCriteriaFilterCriteriaTiêu chí mà bộ lọc sử dụng.

Cầu thủ trả bóng

PivotFilter – Bộ lọc mới.

Ủ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

addPivotValue(columnName)

Thêm một giá trị trục mới dựa trên cột nguồn dữ liệu đã chỉ định mà không có bất kỳ hàm tổng hợp nào. Chỉ dành cho các chỉ số của Looker.

Đoạn mã sau đây cho biết cách bạn có thể thêm một thông tin đo lường Looker làm giá trị trục. 

// TODO(developer): Replace with your spreadsheet ID which has a Looker data
// source.
const spreadsheet = SpreadsheetApp.openById('abcd1234');
const datasource = spreadsheet.getDataSources()[0];
const pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue('columnName');

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

Tham số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà giá trị tổng hợp dựa vào.

Cầu thủ trả bóng

PivotValue – Giá trị tâm mới.

Ủ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

addPivotValue(columnName, summarizeFunction)

Thêm một giá trị trục mới dựa trên cột nguồn dữ liệu đã chỉ định bằng hàm tóm tắt đã chỉ định.

Để thêm giá trị xoay cho các thông tin đo lường Looker, hãy sử dụng addPivotValue(columnName).

Tham số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà giá trị tổng hợp dựa vào.
summarizeFunctionPivotTableSummarizeFunctionHàm tóm tắt mà giá trị trục sử dụng.

Cầu thủ trả bóng

PivotValue – Giá trị tâm mới.

Ủ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

addRowGroup(columnName)

Thêm một nhóm hàng mới trong bảng tổng hợp dựa trên cột nguồn dữ liệu được chỉ định.

Tham số

TênLoạiMô tả
columnNameStringTên cột nguồn dữ liệu mà nhóm tổng hợp dựa vào.

Cầu thủ trả bóng

PivotGroup – Nhóm tổng hợp mới.

Ủ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

asPivotTable()

Trả về bảng tổng hợp nguồn dữ liệu dưới dạng một đối tượng bảng tổng hợp thông thường.

Cầu thủ trả bóng

PivotTable – Bảng tổng hợp.

Ủ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

cancelDataRefresh()

Huỷ quá trình làm mới dữ liệu liên kết với đối tượng này nếu quá trình đó đang chạy.

Ví dụ này cho thấy cách huỷ làm mới công thức. 

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

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

Cầu thủ trả bóng

DataSourcePivotTable – Đối tượng 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

forceRefreshData()

Làm mới dữ liệu của đối tượng này bất kể trạng thái hiện tại. Hãy xem refreshData() để biết thêm thông tin chi tiết. Nếu bạn muốn huỷ quá trình làm mới đang chạy của đối tượng này, hãy xem cancelDataRefresh().

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

Cầu thủ trả bóng

DataSourcePivotTable – Đối tượng 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

getDataSource()

Lấy nguồn dữ liệu mà đối tượng được liên kế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 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

getStatus()

Lấy trạng thái thực thi dữ liệu của đối tượng.

Cầu thủ trả bóng

DataExecutionStatus – Trạng thái thực thi 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

refreshData()

Làm mới dữ liệu của đối tượng.

Khai báo một trường hợp ngoại lệ nếu hiện đang ở trạng thái error. Sử dụng DataSource#updateSpec() để cập nhật quy cách. Phương thức này được ưu tiên hơn forceRefreshData() để ngăn chặn các nội dung chỉnh sửa không mong muốn trên 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 một loại nguồn dữ liệu cụ thể.

Cầu thủ trả bóng

DataSourcePivotTable – Đối tượng 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

waitForCompletion(timeoutInSeconds)

Đợi cho đến khi quá trình thực thi hiện tại hoàn tất, hết thời gian chờ sau số giây đã cung cấp. Trả về 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.

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.

Cầu thủ trả bóng

DataExecutionStatus – Trạng thái thực thi 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