Class DataSourceSpecBuilder

DataSourceSpecBuilder

ผู้สร้างสำหรับ DataSourceSpec หากต้องการสร้างข้อกำหนดเฉพาะสำหรับบางประเภท ให้ใช้เมธอด as...() หากต้องการสร้างเครื่องมือสร้างใหม่ ให้ใช้ SpreadsheetApp.newDataSourceSpec() หากต้องการใช้ข้อกำหนดดังกล่าว โปรดดู DataSourceTable

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

ตัวอย่างนี้แสดงวิธีสร้างข้อกำหนดของแหล่งข้อมูล BigQuery

var spec = SpreadsheetApp.newDataSourceSpec()
           .asBigQuery()
           .setProjectId('big_query_project')
           .setRawQuery('select @FIELD from table limit @LIMIT')
           .setParameterFromCell('FIELD', 'Sheet1!A1')
           .setParameterFromCell('LIMIT', 'namedRangeCell')
           .build();

ตัวอย่างนี้แสดงวิธีสร้างข้อกําหนดของแหล่งข้อมูล Looker โดยจะแสดงผลออบเจ็กต์ LookerDataSourceSpec หลังจากใช้ build()

var spec = SpreadsheetApp.newDataSourceSpec()
           .asLooker()
           .setInstanceUrl('https://looker_instance_url.com')
           .setModelName('model_name')
           .setExploreName('explore_name')
           .build();

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
asBigQuery()	BigQueryDataSourceSpecBuilder	รับเครื่องมือสร้างสำหรับแหล่งข้อมูล BigQuery
asLooker()	LookerDataSourceSpecBuilder	ดาวน์โหลดเครื่องมือสร้างสําหรับแหล่งข้อมูล Looker
build()	DataSourceSpec	สร้างข้อกําหนดของแหล่งข้อมูลจากการตั้งค่าในตัวสร้างนี้
copy()	DataSourceSpecBuilder	สร้าง DataSourceSpecBuilder ตามการตั้งค่าของแหล่งข้อมูลนี้
getParameters()	DataSourceParameter[]	รับพารามิเตอร์ของแหล่งข้อมูล
getType()	DataSourceType	รับประเภทของแหล่งข้อมูล
removeAllParameters()	DataSourceSpecBuilder	นําพารามิเตอร์ทั้งหมดออก
removeParameter(parameterName)	DataSourceSpecBuilder	นำพารามิเตอร์ที่ระบุออก
setParameterFromCell(parameterName, sourceCell)	DataSourceSpecBuilder	เพิ่มพารามิเตอร์ หรือหากมีพารามิเตอร์ที่มีชื่ออยู่แล้ว ให้อัปเดตเซลล์ต้นทางสำหรับเครื่องมือสร้างข้อมูลจำเพาะแหล่งข้อมูลประเภท DataSourceType.BIGQUERY

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

asBigQuery()

รับเครื่องมือสร้างสําหรับแหล่งข้อมูล BigQuery

รีเทิร์น

BigQueryDataSourceSpecBuilder — ตัวสร้างข้อกําหนดแหล่งข้อมูล BigQuery

---

asLooker()

ดาวน์โหลดเครื่องมือสร้างสําหรับแหล่งข้อมูล Looker

var spec = SpreadsheetApp.newDataSourceSpec()
           .asLooker()
           .setInstanceUrl('https://looker_instance_url.com')
           .setModelName('model_name')
           .setExploreName('explore_name')
           .build();

รีเทิร์น

LookerDataSourceSpecBuilder — เครื่องมือสร้างข้อกำหนดของแหล่งข้อมูล Looker

---

build()

สร้างข้อกำหนดของแหล่งข้อมูลจากการตั้งค่าในเครื่องมือสร้างนี้ ต้องใช้ as...() เพื่อระบุประเภทแหล่งข้อมูลก่อนการสร้าง

ตัวอย่างโค้ดต่อไปนี้จะสร้างข้อมูลจำเพาะของแหล่งข้อมูล BigQuery

var bigQueryDataSourceSpec = SpreadsheetApp.newDataSourceSpec().asBigQuery();
// TODO(developer): Replace with the required dataset, project and table IDs.
bigQueryDataSourceSpec.setDatasetId("my data set id");
bigQueryDataSourceSpec.setProjectId("my project id");
bigQueryDataSourceSpec.setTableId("my table id");

bigQueryDataSourceSpec.build();

ตัวอย่างโค้ดต่อไปนี้สร้างข้อกำหนดของแหล่งข้อมูล Looker

var lookerDataSourceSpecBuilder = SpreadsheetApp.newDataSourceSpec().asLooker();
var lookerSpec = lookerDataSourceSpecBuilder.setExploreName("my explore name")
                                            .setInstanceUrl("my instance url")
                                            .setModelName("my model name")
                                            .build();

รีเทิร์น

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

---

copy()

สร้าง DataSourceSpecBuilder ตามการตั้งค่าของแหล่งข้อมูลนี้

// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');
var spec = ss.getDataSources()[0].getSpec();

var newSpec = spec.copy();

รีเทิร์น

DataSourceSpecBuilder — เครื่องมือสร้าง

---

getParameters()

รับพารามิเตอร์ของแหล่งข้อมูล

// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');
var spec = ss.getDataSources()[0].getSpec();
var parameters = spec.getParameters();

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

รีเทิร์น

DataSourceParameter[] — รายการพารามิเตอร์

---

getType()

รับประเภทของแหล่งข้อมูล

// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');
var spec = ss.getDataSources()[0].getSpec();
var type = spec.getType();

รีเทิร์น

DataSourceType — ประเภทแหล่งข้อมูล

---

removeAllParameters()

นำพารามิเตอร์ทั้งหมดออก

var specBuilder = SpreadsheetApp.newDataSourceSpec();
specBuilder.removeAllParameters();

รีเทิร์น

DataSourceSpecBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่

---

removeParameter(parameterName)

นำพารามิเตอร์ที่ระบุออก

var specBuilder = SpreadsheetApp.newDataSourceSpec();
specBuilder.removeParameter("x");

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
parameterName	String	ชื่อพารามิเตอร์ที่จะนำออก

รีเทิร์น

DataSourceSpecBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่

---

setParameterFromCell(parameterName, sourceCell)

เพิ่มพารามิเตอร์ หรือหากพารามิเตอร์ที่มีชื่ออยู่ ให้อัปเดตเซลล์ต้นทางสําหรับข้อมูล เครื่องมือสร้างข้อกำหนดของแหล่งที่มาประเภท DataSourceType.BIGQUERY

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

var specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery();
specBuilder.setParameterFromCell("x", "A1");
var bigQuerySpec = specBuilder.build();

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
parameterName	String	ชื่อพารามิเตอร์
sourceCell	String	เซลล์ต้นทาง ตามที่ระบุไว้ในรูปแบบ A1

รีเทิร์น

DataSourceSpecBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่