Class DataSourceSpecBuilder

DataSourceSpecBuilder

Kreator dla: DataSourceSpec. Aby utworzyć specyfikację dla określonego typu, użyj metody as...(). Aby utworzyć nowy kreator, użyj pliku SpreadsheetApp.newDataSourceSpec(). Aby skorzystać ze specyfikacji, zobacz DataSourceTable.

Używaj tej klasy tylko w przypadku danych połączonych z bazą danych.

Ten przykład pokazuje, jak utworzyć specyfikację źródła danych 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();

Ten przykład pokazuje, jak utworzyć specyfikację źródła danych Looker. Zwraca obiekt LookerDataSourceSpec po użyciu funkcji build().

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

Metody

MetodaZwracany typKrótki opis
asBigQuery()BigQueryDataSourceSpecBuilderPobiera konstruktor źródła danych BigQuery.
asLooker()LookerDataSourceSpecBuilderPobiera kreator dla źródła danych Lookera.
build()DataSourceSpecTworzy specyfikację źródła danych na podstawie ustawień w tym kreatorze.
copy()DataSourceSpecBuilderTworzy element DataSourceSpecBuilder na podstawie ustawień tego źródła danych.
getParameters()DataSourceParameter[]Pobiera parametry źródła danych.
getType()DataSourceTypePobiera typ źródła danych.
removeAllParameters()DataSourceSpecBuilderusuwa wszystkie parametry.
removeParameter(parameterName)DataSourceSpecBuilderUsuwa określony parametr.
setParameterFromCell(parameterName, sourceCell)DataSourceSpecBuilderDodaje parametr, a jeśli parametr o nazwie istnieje, aktualizuje jego komórkę źródłową pod kątem danych kreatory specyfikacji źródłowych typu DataSourceType.BIGQUERY.

Szczegółowa dokumentacja

asBigQuery()

Pobiera kreator dla źródła danych BigQuery.

Powrót

BigQueryDataSourceSpecBuilder – kreator specyfikacji źródła danych BigQuery.


asLooker()

Pobiera kreator dla źródła danych Lookera.

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

Powrót

LookerDataSourceSpecBuilder – kreator specyfikacji źródła danych Lookera.


build()

Tworzy specyfikację źródła danych na podstawie ustawień w tym narzędziu. Musi być używane ustawienie as...() w celu określenia typu źródła danych.

Ten przykład kodu tworzy specyfikację źródła danych 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();

Poniższy przykładowy kod pozwala utworzyć specyfikację źródła danych Lookera.

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

Powrót

DataSourceSpec – specyfikacja źródła danych.


copy()

Tworzy element DataSourceSpecBuilder na podstawie ustawień tego źródła danych.

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

Powrót

DataSourceSpecBuilder – kreator.


getParameters()

Pobiera parametry źródła danych.

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

Ta metoda jest dostępna tylko w przypadku źródeł danych BigQuery.

Powrót

DataSourceParameter[] – lista parametrów.


getType()

Pobiera typ źródła danych.

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

Powrót

DataSourceType – typ źródła danych.


removeAllParameters()

usuwa wszystkie parametry.

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

Powrót

DataSourceSpecBuilder – kreator do łańcuchowania.


removeParameter(parameterName)

Usuwa określony parametr.

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

Parametry

NazwaTypOpis
parameterNameStringNazwa parametru do usunięcia.

Powrót

DataSourceSpecBuilder – kreator do łańcuchowania.


setParameterFromCell(parameterName, sourceCell)

Dodaje parametr, a jeśli parametr o nazwie istnieje, aktualizuje jego komórkę źródłową pod kątem danych kreatory specyfikacji źródłowych typu DataSourceType.BIGQUERY.

Ta metoda jest dostępna tylko w przypadku źródeł danych BigQuery.

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

Parametry

NazwaTypOpis
parameterNameStringNazwa parametru.
sourceCellStringKomórka źródłowa określona w notacji A1.

Powrót

DataSourceSpecBuilder – kreator łańcuchów.