หน้านี้ได้รับการแปลโดย Cloud Translation API

Class DataSourcePivotTable

เข้าถึงและแก้ไขตาราง Pivot ของแหล่งข้อมูลที่มีอยู่ หากต้องการสร้างตาราง Pivot ของแหล่งข้อมูลใหม่ ให้ใช้ Range.createDataSourcePivotTable(dataSource)

ใช้คลาสนี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`addColumnGroup(columnName)`	`PivotGroup`	เพิ่มกลุ่มคอลัมน์ Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ
`addFilter(columnName, filterCriteria)`	`PivotFilter`	เพิ่มตัวกรองใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุพร้อมเกณฑ์ตัวกรองที่ระบุ
`addPivotValue(columnName)`	`PivotValue`	เพิ่มค่า Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุโดยไม่มีฟังก์ชันสรุป
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	เพิ่มค่า Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุด้วยฟังก์ชันสรุปที่ระบุ
`addRowGroup(columnName)`	`PivotGroup`	เพิ่มกลุ่มแถว Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ
`asPivotTable()`	`PivotTable`	แสดงผลตาราง Pivot ของแหล่งข้อมูลเป็นออบเจ็กต์ตาราง Pivot ปกติ
`cancelDataRefresh()`	`DataSourcePivotTable`	ยกเลิกการรีเฟรชข้อมูลที่เชื่อมโยงกับออบเจ็กต์นี้หากกำลังทำงานอยู่
`forceRefreshData()`	`DataSourcePivotTable`	รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน
`getDataSource()`	`DataSource`	รับแหล่งข้อมูลที่ลิงก์กับออบเจ็กต์
`getStatus()`	`DataExecutionStatus`	รับสถานะการดําเนินการข้อมูลของออบเจ็กต์
`refreshData()`	`DataSourcePivotTable`	รีเฟรชข้อมูลของออบเจ็กต์
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	รอจนกว่าการดำเนินการปัจจุบันจะเสร็จสมบูรณ์ โดยระบบจะหมดเวลาหลังจากผ่านไปตามจำนวนวินาทีที่ระบุ

เอกสารประกอบโดยละเอียด

`addColumnGroup(columnName)`

เพิ่มกลุ่มคอลัมน์ Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnName`	`String`	ชื่อคอลัมน์แหล่งข้อมูลของกลุ่ม Pivot

รีเทิร์น

PivotGroup — กลุ่ม Pivot ใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addFilter(columnName, filterCriteria)`

เพิ่มตัวกรองใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุพร้อมเกณฑ์ตัวกรองที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnName`	`String`	ชื่อคอลัมน์แหล่งข้อมูลที่ใช้เป็นตัวกรอง
`filterCriteria`	`FilterCriteria`	เกณฑ์ที่ตัวกรองใช้

รีเทิร์น

PivotFilter — ตัวกรองใหม่

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(columnName)`

เพิ่มค่า Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุโดยไม่มีฟังก์ชันสรุป สําหรับการวัดของ Looker เท่านั้น

โค้ดต่อไปนี้แสดงวิธีเพิ่มการวัดของ Looker เป็นค่า Pivot

// 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');

วิธีนี้ใช้ได้กับแหล่งข้อมูล Looker เท่านั้น

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnName`	`String`	ชื่อคอลัมน์แหล่งข้อมูลที่ใช้เป็นพื้นฐานของค่า Pivot

รีเทิร์น

PivotValue — ค่า Pivot ใหม่

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(columnName, summarizeFunction)`

เพิ่มค่า Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุด้วยฟังก์ชันสรุปที่ระบุ

หากต้องการเพิ่มค่า Pivot สําหรับการวัดของ Looker ให้ใช้ addPivotValue(columnName)

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnName`	`String`	ชื่อคอลัมน์แหล่งข้อมูลที่ใช้เป็นพื้นฐานของค่า Pivot
`summarizeFunction`	`PivotTableSummarizeFunction`	ฟังก์ชันสรุปที่ค่า Pivot ใช้

รีเทิร์น

PivotValue — ค่า Pivot ใหม่

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addRowGroup(columnName)`

เพิ่มกลุ่มแถว Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnName`	`String`	ชื่อคอลัมน์แหล่งข้อมูลของกลุ่ม Pivot

รีเทิร์น

PivotGroup — กลุ่ม Pivot ใหม่

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`asPivotTable()`

แสดงผลตาราง Pivot ของแหล่งข้อมูลเป็นออบเจ็กต์ตาราง Pivot ปกติ

รีเทิร์น

PivotTable — ตาราง Pivot

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`cancelDataRefresh()`

ยกเลิกการรีเฟรชข้อมูลที่เชื่อมโยงกับออบเจ็กต์นี้หากกำลังทำงานอยู่

ตัวอย่างนี้แสดงวิธียกเลิกการรีเฟรชสูตร

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

แสดงข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution() เพื่อเปิดการเรียกใช้ข้อมูลจากแหล่งข้อมูลประเภทที่เฉพาะเจาะจง

รีเทิร์น

DataSourcePivotTable — ออบเจ็กต์ข้อมูล

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`forceRefreshData()`

รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน ดูรายละเอียดเพิ่มเติมได้ที่ refreshData() หากต้องการยกเลิกการรีเฟรชออบเจ็กต์นี้ที่ดำเนินการอยู่ในปัจจุบัน โปรดดูที่ cancelDataRefresh()

รีเทิร์น

DataSourcePivotTable — ออบเจ็กต์ข้อมูล

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSource()`

รับแหล่งข้อมูลที่ลิงก์กับออบเจ็กต์

รีเทิร์น

DataSource — แหล่งข้อมูล

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getStatus()`

รับสถานะการดําเนินการข้อมูลของออบเจ็กต์

รีเทิร์น

DataExecutionStatus — สถานะการเรียกใช้ข้อมูล

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshData()`

รีเฟรชข้อมูลของออบเจ็กต์

โยนข้อยกเว้นหากอยู่ในสถานะ error ในปัจจุบัน ใช้ DataSource#updateSpec() เพื่ออัปเดตข้อกำหนด เราขอแนะนำให้ใช้วิธีนี้แทน forceRefreshData() เพื่อป้องกันไม่ให้มีการแก้ไขแหล่งข้อมูลโดยไม่คาดคิด

รีเทิร์น

DataSourcePivotTable — ออบเจ็กต์ข้อมูล

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForCompletion(timeoutInSeconds)`

รอจนกว่าการดำเนินการปัจจุบันจะเสร็จสมบูรณ์ โดยระบบจะหมดเวลาหลังจากผ่านไปตามจำนวนวินาทีที่ระบุ โยนข้อยกเว้นหากการดําเนินการไม่เสร็จสมบูรณ์เมื่อหมดเวลา แต่จะไม่ยกเลิกการดําเนินการกับข้อมูล

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`timeoutInSeconds`	`Integer`	เวลาที่รอการเรียกใช้ข้อมูลเป็นวินาที สูงสุด 300 วินาที

รีเทิร์น

DataExecutionStatus — สถานะการเรียกใช้ข้อมูล

การให้สิทธิ์

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets