Class DataSourceSpecBuilder

DataSourceSpecBuilder

Trình tạo cho DataSourceSpec. Để tạo thông số kỹ thuật cho một loại nhất định, hãy sử dụng phương thức as...(). Để tạo một trình tạo mới, hãy sử dụng SpreadsheetApp.newDataSourceSpec(). Để sử dụng thông số kỹ thuật, hãy xem DataSourceTable.

Chỉ sử dụng lớp này với dữ liệu được kết nối với cơ sở dữ liệu.

Ví dụ này cho biết cách tạo thông số nguồn dữ liệu 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();

Ví dụ này cho biết cách tạo thông số kỹ thuật nguồn dữ liệu Looker. Phương thức này trả về đối tượng LookerDataSourceSpec sau khi sử dụng build().

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

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
asBigQuery()	BigQueryDataSourceSpecBuilder	Tải trình tạo cho nguồn dữ liệu BigQuery.
asLooker()	LookerDataSourceSpecBuilder	Tải trình tạo cho nguồn dữ liệu Looker.
build()	DataSourceSpec	Tạo một thông số kỹ thuật nguồn dữ liệu từ phần cài đặt trong trình tạo này.
copy()	DataSourceSpecBuilder	Tạo DataSourceSpecBuilder dựa trên chế độ cài đặt của nguồn dữ liệu này.
getParameters()	DataSourceParameter[]	Lấy các tham số của nguồn dữ liệu.
getType()	DataSourceType	Lấy loại nguồn dữ liệu.
removeAllParameters()	DataSourceSpecBuilder	Xoá tất cả thông số.
removeParameter(parameterName)	DataSourceSpecBuilder	Xoá tham số đã chỉ định.
setParameterFromCell(parameterName, sourceCell)	DataSourceSpecBuilder	Thêm một tham số, hoặc nếu tham số có tên tồn tại, sẽ cập nhật ô nguồn cho dữ liệu trình tạo thông số nguồn thuộc loại DataSourceType.BIGQUERY.

Tài liệu chi tiết

asBigQuery()

Lấy trình tạo cho nguồn dữ liệu BigQuery.

Cầu thủ trả bóng

BigQueryDataSourceSpecBuilder — Trình tạo thông số nguồn dữ liệu của BigQuery.

---

asLooker()

Tải trình tạo cho nguồn dữ liệu Looker.

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

Cầu thủ trả bóng

LookerDataSourceSpecBuilder — Trình tạo thông số kỹ thuật nguồn dữ liệu của Looker.

---

build()

Tạo thông số nguồn dữ liệu từ các chế độ cài đặt trong trình tạo này. Phải dùng as...() để chỉ định loại nguồn dữ liệu trước khi tạo.

Mã mẫu sau đây tạo một Thông số kỹ thuật về nguồn dữ liệu 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();

Mã mẫu sau đây sẽ tạo một Thông số kỹ thuật của Looker DataSource.

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

Cầu thủ trả bóng

DataSourceSpec – Thông số nguồn dữ liệu.

---

copy()

Tạo một DataSourceSpecBuilder dựa trên chế độ cài đặt của nguồn dữ liệu này.

// 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();

Cầu thủ trả bóng

DataSourceSpecBuilder — Trình tạo.

---

getParameters()

Lấy các tham số của nguồn dữ liệu.

// 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();

Phương thức này chỉ áp dụng cho nguồn dữ liệu BigQuery.

Cầu thủ trả bóng

DataSourceParameter[] – Danh sách tham số.

---

getType()

Xem loại nguồn dữ liệu.

// 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();

Cầu thủ trả bóng

DataSourceType — Loại nguồn dữ liệu.

---

removeAllParameters()

Xoá tất cả thông số.

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

Cầu thủ trả bóng

DataSourceSpecBuilder – Trình tạo để tạo chuỗi.

---

removeParameter(parameterName)

Xoá thông số đã chỉ định.

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

Thông số

Tên	Loại	Mô tả
parameterName	String	Tên của thông số cần xoá.

Cầu thủ trả bóng

DataSourceSpecBuilder – Trình tạo, để tạo chuỗi.

---

setParameterFromCell(parameterName, sourceCell)

Thêm một tham số, hoặc nếu tham số có tên tồn tại, sẽ cập nhật ô nguồn cho dữ liệu trình tạo thông số nguồn thuộc loại DataSourceType.BIGQUERY.

Phương pháp này chỉ áp dụng cho nguồn dữ liệu BigQuery.

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

Thông số

Tên	Loại	Mô tả
parameterName	String	Tên thông số.
sourceCell	String	Ô nguồn, như được chỉ định trong ký hiệu A1.

Cầu thủ trả bóng

DataSourceSpecBuilder – Trình tạo để tạo chuỗi.