Class DataSourceSpecBuilder

DataSourceSpecBuilder

Kreator dla DataSourceSpec. Aby utworzyć specyfikację dla określonego typu, użyj metody as...(). Aby utworzyć nowego buildera, użyj SpreadsheetApp.newDataSourceSpec(). Informacje o korzystaniu ze specyfikacji znajdziesz w artykule 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.

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

const 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 narzędzie do tworzenia źródła danych BigQuery.
asLooker()	LookerDataSourceSpecBuilder	Pobiera narzędzie do tworzenia źródła danych Looker.
build()	DataSourceSpec	Tworzy specyfikację źródła danych na podstawie ustawień w tym kreatorze.
copy()	DataSourceSpecBuilder	Tworzy 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 lub, jeśli parametr o tej nazwie już istnieje, aktualizuje jego komórkę źródłową w przypadku konstruktorów specyfikacji źródła danych typu DataSourceType.BIGQUERY.

Szczegółowa dokumentacja

asBigQuery()

Pobiera narzędzie do tworzenia źródła danych BigQuery.

Powrót

BigQueryDataSourceSpecBuilder – narzędzie do tworzenia specyfikacji źródła danych BigQuery.

---

asLooker()

Pobiera narzędzie do tworzenia źródła danych Looker.

const 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 Looker.

---

build()

Tworzy specyfikację źródła danych na podstawie ustawień w tym kreatorze. Przed utworzeniem musisz użyć as...(), aby określić typ źródła danych.

Poniższy przykładowy kod tworzy specyfikację źródła danych 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();

Poniższy przykładowy kod tworzy specyfikację źródła danych Looker.

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

const newSpec = spec.copy();

Powrót

DataSourceSpecBuilder – monter.

---

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

Powrót

DataSourceType – typ źródła danych.

---

removeAllParameters()

Usuwa wszystkie parametry.

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

Powrót

DataSourceSpecBuilder – narzędzie do tworzenia, do łączenia.

---

removeParameter(parameterName)

Usuwa określony parametr.

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

Parametry

Nazwa	Typ	Opis
parameterName	String	Nazwa parametru do usunięcia.

Powrót

DataSourceSpecBuilder – narzędzie do tworzenia, do łączenia.

---

setParameterFromCell(parameterName, sourceCell)

Dodaje parametr lub, jeśli parametr o tej nazwie już istnieje, aktualizuje jego komórkę źródłową w przypadku konstruktorów specyfikacji źródła danych typu DataSourceType.BIGQUERY.

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

const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery();
specBuilder.setParameterFromCell('x', 'A1');
const 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 – narzędzie do tworzenia, do łączenia.