เข้าถึงและแก้ไขแหล่งข้อมูลที่มีอยู่ หากต้องการสร้างตารางแหล่งข้อมูลด้วยแหล่งข้อมูลใหม่ โปรดดู
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)
สร้างคอลัมน์ที่คำนวณ วิธีนี้ใช้ได้กับแหล่งข้อมูล BigQuery เท่านั้น
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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()
สร้างตารางแหล่งข้อมูลจากแหล่งข้อมูลนี้ในเซลล์แรกของชีตใหม่ ด้านข้าง จะทำให้แผ่นงานใหม่เป็นแผ่นงานที่ใช้งานอยู่
วิธีนี้ใช้ได้กับแหล่งข้อมูล BigQuery เท่านั้น
รีเทิร์น
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()
แสดงผลคอลัมน์ที่คำนวณแล้วทั้งหมดในแหล่งข้อมูล
ข้อกําหนดของแหล่งข้อมูลประเภท DataSourceType.LOOKER
แสดงผลอาร์เรย์ว่าง
รีเทิร์น
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