Ta strona została przetłumaczona przez Cloud Translation API.

Class DataSourceSpecBuilder

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.