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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
asBigQuery() | BigQueryDataSourceSpecBuilder | Pobiera konstruktor źródła danych BigQuery. |
asLooker() | LookerDataSourceSpecBuilder | Pobiera kreator dla źródła danych Lookera. |
build() | DataSourceSpec | Tworzy specyfikację źródła danych na podstawie ustawień w tym kreatorze. |
copy() | DataSourceSpecBuilder | Tworzy element DataSourceSpecBuilder na podstawie ustawień tego źródła danych. |
getParameters() | DataSourceParameter[] | Pobiera parametry źródła danych. |
getType() | DataSourceType | Pobiera typ źródła danych. |
removeAllParameters() | DataSourceSpecBuilder | usuwa wszystkie parametry. |
removeParameter(parameterName) | DataSourceSpecBuilder | Usuwa określony parametr. |
setParameterFromCell(parameterName, sourceCell) | DataSourceSpecBuilder | 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 . |
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
Nazwa | Typ | Opis |
---|---|---|
parameterName | String | Nazwa 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
Nazwa | Typ | Opis |
---|---|---|
parameterName | String | Nazwa parametru. |
sourceCell | String | Komórka źródłowa określona w notacji A1. |
Powrót
DataSourceSpecBuilder
– kreator łańcuchów.