Trang này được dịch bởi Cloud Translation API.

Class 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ố kỹ thuật nguồn dữ liệu BigQuery.

const 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ề một đối tượng LookerDataSourceSpec sau khi sử dụng build().

const 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	Loại dữ liệu trả về	Mô tả ngắn
`asBigQuery()`	`BigQueryDataSourceSpecBuilder`	Lấy trình tạo cho nguồn dữ liệu BigQuery.
`asLooker()`	`LookerDataSourceSpecBuilder`	Lấy trình tạo cho nguồn dữ liệu Looker.
`build()`	`DataSourceSpec`	Tạo thông số nguồn dữ liệu từ các chế độ 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ả tham 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, hãy cập nhật ô nguồn của tham số đó cho trình tạo thông số kỹ thuật nguồn dữ liệu 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ố kỹ thuật nguồn dữ liệu BigQuery.

`asLooker()`

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

const 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ố nguồn dữ liệu 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 sử 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.

const 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 tạo một Thông số kỹ thuật về Nguồn dữ liệu Looker.

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();
const 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 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',
);
const spec = ss.getDataSources()[0].getSpec();

const 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',
);
const spec = ss.getDataSources()[0].getSpec();
const 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()`

Lấy 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',
);
const spec = ss.getDataSources()[0].getSpec();
const type = spec.getType();

Cầu thủ trả bóng

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

`removeAllParameters()`

Xoá tất cả tham số.

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

Cầu thủ trả bóng

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

`removeParameter(parameterName)`

Xoá tham số đã chỉ định.

const specBuilder = SpreadsheetApp.newDataSourceSpec();
specBuilder.removeParameter('x');

Tham 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, hãy cập nhật ô nguồn của tham số đó cho trình tạo thông số kỹ thuật nguồn dữ liệu thuộc loại DataSourceType.BIGQUERY.

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

const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery();
specBuilder.setParameterFromCell('x', 'A1');
const bigQuerySpec = specBuilder.build();

Tham 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.