Class DataSourceSpecBuilder

DataSourceSpecBuilder

Builder untuk DataSourceSpec. Untuk membuat spesifikasi untuk jenis tertentu, gunakan metode as...(). Untuk membuat builder baru, gunakan SpreadsheetApp.newDataSourceSpec(). Untuk menggunakan spesifikasi ini, lihat DataSourceTable.

Hanya gunakan class ini dengan data yang terhubung ke database.

Contoh ini menunjukkan cara membuat spesifikasi sumber data 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();

Contoh ini menunjukkan cara membuat spesifikasi sumber data Looker. Metode ini menampilkan objek LookerDataSourceSpec setelah menggunakan build().

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

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
asBigQuery()BigQueryDataSourceSpecBuilderMendapatkan builder untuk sumber data BigQuery.
asLooker()LookerDataSourceSpecBuilderMendapatkan builder untuk sumber data Looker.
build()DataSourceSpecMembuat spesifikasi sumber data dari setelan di builder ini.
copy()DataSourceSpecBuilderMembuat DataSourceSpecBuilder berdasarkan setelan sumber data ini.
getParameters()DataSourceParameter[]Mendapatkan parameter sumber data.
getType()DataSourceTypeMendapatkan jenis sumber data.
removeAllParameters()DataSourceSpecBuilderMenghapus semua parameter.
removeParameter(parameterName)DataSourceSpecBuilderMenghapus parameter yang ditentukan.
setParameterFromCell(parameterName, sourceCell)DataSourceSpecBuilderMenambahkan parameter, atau jika parameter dengan nama tersebut ada, memperbarui sel sumbernya untuk pembuat spec sumber data dari jenis DataSourceType.BIGQUERY.

Dokumentasi mendetail

asBigQuery()

Mendapatkan builder untuk sumber data BigQuery.

Pulang pergi

BigQueryDataSourceSpecBuilder — Builder spesifikasi sumber data BigQuery.


asLooker()

Mendapatkan builder untuk sumber data Looker.

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

Pulang pergi

LookerDataSourceSpecBuilder — Pembuat spesifikasi sumber data Looker.


build()

Membuat spesifikasi sumber data dari setelan di builder ini. Harus menggunakan as...() untuk menentukan jenis sumber data sebelum membangun.

Contoh kode berikut mem-build Spesifikasi DataSource 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();

Contoh kode berikut membuat Spesifikasi DataSource Looker.

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

Pulang pergi

DataSourceSpec — Spesifikasi sumber data.


copy()

Membuat DataSourceSpecBuilder berdasarkan setelan sumber data ini.

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

Pulang pergi

DataSourceSpecBuilder — Builder.


getParameters()

Mendapatkan parameter sumber data.

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

Metode ini hanya tersedia untuk sumber data BigQuery.

Pulang pergi

DataSourceParameter[] — Daftar parameter.


getType()

Mendapatkan jenis sumber data.

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

Pulang pergi

DataSourceType — Jenis sumber data.


removeAllParameters()

Menghapus semua parameter.

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

Pulang pergi

DataSourceSpecBuilder — Builder, untuk perantaian.


removeParameter(parameterName)

Menghapus parameter yang ditentukan.

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

Parameter

NamaJenisDeskripsi
parameterNameStringNama parameter yang akan dihapus.

Pulang pergi

DataSourceSpecBuilder — Builder, untuk perantaian.


setParameterFromCell(parameterName, sourceCell)

Menambahkan parameter, atau jika parameter dengan nama ada, akan memperbarui sel sumbernya untuk data builder spesifikasi sumber jenis DataSourceType.BIGQUERY.

Metode ini hanya tersedia untuk sumber data BigQuery.

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

Parameter

NamaJenisDeskripsi
parameterNameStringNama parameter.
sourceCellStringSel sumber, seperti yang ditentukan dalam notasi A1.

Pulang pergi

DataSourceSpecBuilder — Builder, untuk perantaian.