Class DataSourceSpecBuilder

DataSourceSpecBuilder

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

Hanya gunakan class ini dengan data yang terhubung ke database.

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

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

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

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
asBigQuery()	BigQueryDataSourceSpecBuilder	Mendapatkan builder untuk sumber data BigQuery.
asLooker()	LookerDataSourceSpecBuilder	Mendapatkan builder untuk sumber data Looker.
build()	DataSourceSpec	Membangun spesifikasi sumber data dari setelan di builder ini.
copy()	DataSourceSpecBuilder	Membuat DataSourceSpecBuilder berdasarkan setelan sumber data ini.
getParameters()	DataSourceParameter[]	Mendapatkan parameter sumber data.
getType()	DataSourceType	Mendapatkan jenis sumber data.
removeAllParameters()	DataSourceSpecBuilder	Menghapus semua parameter.
removeParameter(parameterName)	DataSourceSpecBuilder	Menghapus parameter yang ditentukan.
setParameterFromCell(parameterName, sourceCell)	DataSourceSpecBuilder	Menambahkan parameter, atau jika parameter dengan nama tersebut ada, memperbarui sel sumbernya untuk pembuat spesifikasi sumber data jenis DataSourceType.BIGQUERY.

Dokumentasi mendetail

asBigQuery()

Mendapatkan builder untuk sumber data BigQuery.

Pulang pergi

BigQueryDataSourceSpecBuilder — Pembuat spesifikasi sumber data BigQuery.

---

asLooker()

Mendapatkan builder untuk sumber data Looker.

const 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()

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

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

Contoh kode berikut membuat Spesifikasi DataSource Looker.

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

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

Pulang pergi

DataSourceType — Jenis sumber data.

---

removeAllParameters()

Menghapus semua parameter.

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

Pulang pergi

DataSourceSpecBuilder — Builder, untuk dirangkaikan.

---

removeParameter(parameterName)

Menghapus parameter yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
parameterName	String	Nama parameter yang akan dihapus.

Pulang pergi

DataSourceSpecBuilder — Builder, untuk dirangkaikan.

---

setParameterFromCell(parameterName, sourceCell)

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

Metode ini hanya tersedia untuk sumber data BigQuery.

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

Parameter

Nama	Jenis	Deskripsi
parameterName	String	Nama parameter.
sourceCell	String	Sel sumber, sebagaimana ditentukan dalam notasi A1.

Pulang pergi

DataSourceSpecBuilder — Builder, untuk dirangkaikan.