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

Class 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 — เครื่องมือสร้างสำหรับการทำสายโซ่