เข้าถึงและแก้ไขแหล่งข้อมูลที่มีอยู่ หากต้องการสร้างตารางแหล่งข้อมูลด้วยแหล่งข้อมูลใหม่ โปรดดู 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 — คอลัมน์ที่คำนวณแล้วที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTableOnNewSheet()
สร้างตาราง Pivot ของแหล่งข้อมูลจากแหล่งข้อมูลนี้ในเซลล์แรกของชีตใหม่ ผลที่เกิดขึ้นคือทำให้ชีตใหม่เป็นชีตที่ใช้งานอยู่
รีเทิร์น
DataSourcePivotTable — ตาราง Pivot ของแหล่งข้อมูลที่สร้างใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
createDataSourceTableOnNewSheet()
สร้างตารางแหล่งข้อมูลจากแหล่งข้อมูลนี้ในเซลล์แรกของชีตใหม่ ผลข้างเคียงคือ ทำให้ชีตใหม่เป็นชีตที่ใช้งานอยู่
รีเทิร์น
DataSourceTable — ตารางแหล่งข้อมูลที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumnByName(columnName)
แสดงผลคอลัมน์ที่คำนวณในแหล่งข้อมูลที่ตรงกับชื่อคอลัมน์
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
columnName | String | ชื่อของคอลัมน์ที่คำนวณที่จะรับ |
รีเทิร์น
DataSourceColumn — คอลัมน์ที่คำนวณแล้วซึ่งตรงกับชื่อคอลัมน์ หรือ null หากไม่มีคอลัมน์ที่คำนวณเช่นนั้น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumns()
แสดงคอลัมน์ที่คำนวณแล้วทั้งหมดในแหล่งข้อมูล
รีเทิร์น
DataSourceColumn[] — อาร์เรย์ของคอลัมน์ที่คำนวณแล้วทั้งหมดในแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getColumns()
แสดงผลคอลัมน์ทั้งหมดในแหล่งข้อมูล
รีเทิร์น
DataSourceColumn[] — อาร์เรย์ของ DataSourceColumn ทั้งหมดในแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
แสดงชีตแหล่งข้อมูลที่เชื่อมโยงกับแหล่งข้อมูลนี้
รีเทิร์น
DataSourceSheet[] — อาร์เรย์ของชีตแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getSpec()
รับข้อกำหนดของแหล่งข้อมูล
รีเทิร์น
DataSourceSpec — ข้อกำหนดของแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
refreshAllLinkedDataSourceObjects()
รีเฟรชออบเจ็กต์แหล่งข้อมูลทั้งหมดที่ลิงก์กับแหล่งข้อมูล
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution() เพื่อเปิดใช้การดำเนินการกับข้อมูลสำหรับประเภทแหล่งข้อมูลที่ระบุ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec)
อัปเดตข้อกำหนดของแหล่งข้อมูลและรีเฟรชออบเจ็กต์แหล่งข้อมูลที่ลิงก์กับแหล่งข้อมูลนี้ด้วยข้อกำหนดใหม่
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution() เพื่อเปิดใช้การดำเนินการกับข้อมูลสำหรับประเภทแหล่งข้อมูลที่ระบุ
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
spec | DataSourceSpec | ข้อกำหนดของแหล่งข้อมูลที่จะอัปเดต |
รีเทิร์น
DataSource — แหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec, refreshAllLinkedObjects)
อัปเดตข้อกำหนดของแหล่งข้อมูลและรีเฟรช data
source sheets ที่ลิงก์ไว้ด้วยข้อกำหนดใหม่
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution() เพื่อเปิดใช้การดำเนินการกับข้อมูลสำหรับประเภทแหล่งข้อมูลที่ระบุ
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
spec | DataSourceSpec | ข้อกำหนดของแหล่งข้อมูลที่จะอัปเดต |
refreshAllLinkedObjects | Boolean | หากเป็น true ให้รีเฟรชออบเจ็กต์แหล่งข้อมูลทั้งหมดที่ลิงก์กับแหล่งข้อมูลนี้ด้วย |
รีเทิร์น
DataSource — แหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
รอจนกว่าการดำเนินการปัจจุบันทั้งหมดของออบเจ็กต์แหล่งข้อมูลที่ลิงก์จะเสร็จสมบูรณ์ แล้วหมดเวลาหลังจากใช้งานครบตามจำนวนวินาทีที่ระบุ ระบบจะแสดงข้อผิดพลาดหากการดำเนินการไม่เสร็จสมบูรณ์เมื่อหมดเวลา แต่ไม่ได้ยกเลิกการดำเนินการกับข้อมูล
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
timeoutInSeconds | Integer | เวลาที่รอการทำงานของข้อมูล หน่วยเป็นวินาที มีความยาวไม่เกิน 300 วินาที |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets