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

Class DataSource

เข้าถึงและแก้ไขแหล่งข้อมูลที่มีอยู่ หากต้องการสร้างตารางแหล่งข้อมูลด้วยแหล่งข้อมูลใหม่ โปรดดู DataSourceTable

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

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`cancelAllLinkedDataSourceObjectRefreshes()`	`void`	ยกเลิกการรีเฟรชออบเจ็กต์แหล่งข้อมูลที่กำลังทำงานอยู่ทั้งหมดที่ลิงก์กับแหล่งข้อมูลนี้
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	สร้างคอลัมน์ที่คำนวณ
`createDataSourcePivotTableOnNewSheet()`	`DataSourcePivotTable`	สร้างตาราง Pivot ของแหล่งข้อมูลจากแหล่งข้อมูลนี้ในเซลล์แรกของชีตใหม่
`createDataSourceTableOnNewSheet()`	`DataSourceTable`	สร้างตารางแหล่งข้อมูลจากแหล่งข้อมูลนี้ในเซลล์แรกของชีตใหม่
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	แสดงผลคอลัมน์ที่คำนวณในแหล่งข้อมูลที่ตรงกับชื่อคอลัมน์
`getCalculatedColumns()`	`DataSourceColumn[]`	แสดงผลคอลัมน์ที่คำนวณทั้งหมดในแหล่งข้อมูล
`getColumns()`	`DataSourceColumn[]`	แสดงผลคอลัมน์ทั้งหมดในแหล่งข้อมูล
`getDataSourceSheets()`	`DataSourceSheet[]`	แสดงผลแผ่นงานแหล่งข้อมูลที่เชื่อมโยงกับแหล่งข้อมูลนี้
`getSpec()`	`DataSourceSpec`	รับข้อกำหนดของแหล่งข้อมูล
`refreshAllLinkedDataSourceObjects()`	`void`	รีเฟรชออบเจ็กต์แหล่งข้อมูลทั้งหมดที่ลิงก์กับแหล่งข้อมูล
`updateSpec(spec)`	`DataSource`	อัปเดตข้อกำหนดของแหล่งข้อมูลและรีเฟรชออบเจ็กต์แหล่งข้อมูลที่ลิงก์กับ แหล่งข้อมูลที่มีข้อกำหนดใหม่
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	อัปเดตข้อกำหนดของแหล่งข้อมูลและรีเฟรช `data source sheets` ที่ลิงก์ด้วยข้อกำหนดใหม่
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	รอจนกว่าการดำเนินการปัจจุบันทั้งหมดของออบเจ็กต์แหล่งข้อมูลที่ลิงก์จะเสร็จสมบูรณ์ จากนั้นจะหมดเวลา หลังจากจำนวนวินาทีที่ระบุ

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

`cancelAllLinkedDataSourceObjectRefreshes()`

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

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

SpreadsheetApp.enableBigQueryExecution();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

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

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

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

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

`createCalculatedColumn(name, formula)`

สร้างคอลัมน์ที่คำนวณ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อของคอลัมน์ที่คำนวณ
`formula`	`String`	สูตรคอลัมน์ที่คำนวณ

รีเทิร์น

DataSourceColumn — คอลัมน์ที่คำนวณแล้วที่สร้างขึ้นใหม่

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

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

`createDataSourcePivotTableOnNewSheet()`

สร้างตาราง Pivot ของแหล่งข้อมูลจากแหล่งข้อมูลนี้ในเซลล์แรกของชีตใหม่ เพื่อ จะทำให้แผ่นงานใหม่นี้เป็นแผ่นงานที่ใช้งานอยู่

รีเทิร์น

DataSourcePivotTable — ตาราง Pivot ของแหล่งข้อมูลที่สร้างใหม่

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

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

`createDataSourceTableOnNewSheet()`

สร้างตารางแหล่งข้อมูลจากแหล่งข้อมูลนี้ในเซลล์แรกของชีตใหม่ ด้านข้าง จะทำให้แผ่นงานใหม่เป็นแผ่นงานที่ใช้งานอยู่

รีเทิร์น

DataSourceTable — ตารางแหล่งข้อมูลที่สร้างใหม่

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

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

`getCalculatedColumnByName(columnName)`

แสดงผลคอลัมน์ที่คำนวณในแหล่งข้อมูลที่ตรงกับชื่อคอลัมน์

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`columnName`	`String`	ชื่อของคอลัมน์ที่คำนวณเพื่อดู

รีเทิร์น

DataSourceColumn — คอลัมน์ที่คำนวณซึ่งตรงกับชื่อคอลัมน์ หรือ null หากไม่มี ที่คำนวณแล้ว

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

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

`getCalculatedColumns()`

แสดงผลคอลัมน์ที่คำนวณทั้งหมดในแหล่งข้อมูล

รีเทิร์น

DataSourceColumn[] — อาร์เรย์ของคอลัมน์ทั้งหมดที่คำนวณแล้วในแหล่งข้อมูล

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

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

`getColumns()`

แสดงผลคอลัมน์ทั้งหมดในแหล่งข้อมูล

รีเทิร์น

DataSourceColumn[] — อาร์เรย์ของ DataSourceColumn ทั้งหมดในแหล่งข้อมูล

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

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

`getDataSourceSheets()`

แสดงผลแผ่นงานแหล่งข้อมูลที่เชื่อมโยงกับแหล่งข้อมูลนี้

รีเทิร์น

DataSourceSheet[] — อาร์เรย์ของชีตแหล่งข้อมูล

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

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

`getSpec()`

รับข้อกำหนดของแหล่งข้อมูล

รีเทิร์น

DataSourceSpec — ข้อกำหนดของแหล่งข้อมูล

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

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

`refreshAllLinkedDataSourceObjects()`

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

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

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

`updateSpec(spec)`

อัปเดตข้อกำหนดของแหล่งข้อมูลและรีเฟรชออบเจ็กต์แหล่งข้อมูลที่ลิงก์กับ แหล่งข้อมูลที่มีข้อกำหนดใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`spec`	`DataSourceSpec`	ข้อกำหนดของแหล่งข้อมูลที่จะอัปเดต

รีเทิร์น

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

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

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

`updateSpec(spec, refreshAllLinkedObjects)`

อัปเดตข้อกำหนดของแหล่งข้อมูลและรีเฟรช data source sheets ที่ลิงก์ด้วยข้อกำหนดใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`spec`	`DataSourceSpec`	ข้อกำหนดของแหล่งข้อมูลที่จะอัปเดต
`refreshAllLinkedObjects`	`Boolean`	หากเป็น `true` จะรีเฟรชออบเจ็กต์แหล่งข้อมูลทั้งหมดด้วย ลิงก์กับแหล่งข้อมูลนี้

รีเทิร์น

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

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

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

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

พารามิเตอร์

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

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

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