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

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. 

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

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

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 mem-build 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 pengaitan.

removeParameter(parameterName)

Menghapus parameter yang ditentukan. 

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

Parameter

NamaJenisDeskripsi
parameterNameStringNama parameter yang akan dihapus.

Pulang pergi

DataSourceSpecBuilder — Builder, untuk pengaitan.

setParameterFromCell(parameterName, sourceCell)

Menambahkan parameter, atau jika parameter dengan nama tersebut ada, memperbarui sel sumbernya untuk pembuat spec sumber data dari 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

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

Pulang pergi

DataSourceSpecBuilder — Builder, untuk pengaitan.