Class DataSourceSpecBuilder

ŹródłodanychSpecBuilder

Konstruktor DataSourceSpec. Aby utworzyć specyfikację określonego typu, użyj metody as...(). Aby utworzyć nowy kreator, użyj SpreadsheetApp.newDataSourceSpec(). Informacje o specyfikacji znajdziesz w artykule DataSourceTable.

Używaj tej klasy tylko z danymi połączonymi 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 funkcji 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 konstruktor źródła danych BigQuery.
asLooker()	LookerDataSourceSpecBuilder	Pobiera kreator źródła danych Looker.
build()	DataSourceSpec	Na podstawie ustawień w tym kreatorze tworzy specyfikację źródła danych.
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 danej nazwie już istnieje, aktualizuje jego komórkę źródłową dla konstruktorów specyfikacji źródeł danych typu DataSourceType.BIGQUERY.

Szczegółowa dokumentacja

asBigQuery()

Pobiera konstruktor źródła danych BigQuery.

Powrót

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

---

asLooker()

Pobiera kreator ź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()

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

Ten przykład kodu 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();

Ten 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 – 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',
);
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 – kreator do łańcuchowania.

---

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 – kreator do łańcuchowania.

---

setParameterFromCell(parameterName, sourceCell)

Dodaje parametr lub, jeśli parametr o danej nazwie już istnieje, aktualizuje jego komórkę źródłową dla konstruktorów specyfikacji źródeł 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 – kreator do łańcuchowania.