Class DataSourceSpecBuilder

DataSourceSpecBuilder

Lo strumento di creazione per DataSourceSpec. Per creare una specifica per un determinato tipo, utilizza il metodo as...(). Per creare un nuovo generatore, utilizza SpreadsheetApp.newDataSourceSpec(). Per utilizzare la specifica, consulta DataSourceTable.

Utilizza questa classe solo con dati collegati a un database.

Questo esempio mostra come creare una specifica dell'origine dati 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();

Questo esempio mostra come creare una specifica dell'origine dati di Looker. Restituisce un oggetto LookerDataSourceSpec dopo aver utilizzato build().

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

Metodi

MetodoTipo restituitoBreve descrizione
asBigQuery()BigQueryDataSourceSpecBuilderOttiene il builder per l'origine dati BigQuery.
asLooker()LookerDataSourceSpecBuilderOttiene il generatore per l'origine dati di Looker.
build()DataSourceSpecCrea una specifica dell'origine dati dalle impostazioni di questo builder.
copy()DataSourceSpecBuilderCrea un valore DataSourceSpecBuilder in base alle impostazioni di questa origine dati.
getParameters()DataSourceParameter[]Restituisce i parametri dell'origine dati.
getType()DataSourceTypeRestituisce il tipo di origine dati.
removeAllParameters()DataSourceSpecBuilderRimuove tutti i parametri.
removeParameter(parameterName)DataSourceSpecBuilderRimuove il parametro specificato.
setParameterFromCell(parameterName, sourceCell)DataSourceSpecBuilderAggiunge un parametro oppure, se il parametro con il nome esiste, aggiorna la sua cella di origine per i dati builder di specifiche di origine di tipo DataSourceType.BIGQUERY.

Documentazione dettagliata

asBigQuery()

Ottiene il builder per l'origine dati BigQuery.

Invio

BigQueryDataSourceSpecBuilder: lo strumento per la creazione di specifiche delle origini dati BigQuery.


asLooker()

Ottiene il generatore per l'origine dati di Looker.

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

Invio

LookerDataSourceSpecBuilder: lo strumento per la creazione delle specifiche dell'origine dati di Looker.


build()

Crea una specifica dell'origine dati dalle impostazioni di questo builder. Deve usare as...() per specificare un tipo di origine dati prima di crearla.

Il seguente esempio di codice crea una specifica BigQuery DataSource.

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

Il seguente esempio di codice crea una specifica Looker DataSource.

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

Invio

DataSourceSpec: la specifica dell'origine dati.


copy()

Crea un valore DataSourceSpecBuilder in base alle impostazioni di questa origine dati.

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

Invio

DataSourceSpecBuilder: il generatore.


getParameters()

Recupera i parametri dell'origine dati.

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

Questo metodo è disponibile solo per le origini dati BigQuery.

Invio

DataSourceParameter[]: l'elenco dei parametri.


getType()

Restituisce il tipo di origine dati.

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

Invio

DataSourceType: il tipo di origine dati.


removeAllParameters()

Rimuove tutti i parametri.

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

Invio

DataSourceSpecBuilder - Lo strumento di creazione, per il concatenamento.


removeParameter(parameterName)

Rimuove il parametro specificato.

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

Parametri

NomeTipoDescrizione
parameterNameStringIl nome del parametro da rimuovere.

Invio

DataSourceSpecBuilder - Lo strumento di creazione, per il concatenamento.


setParameterFromCell(parameterName, sourceCell)

Aggiunge un parametro oppure, se il parametro con il nome esiste, aggiorna la sua cella di origine per i dati builder di specifiche di origine di tipo DataSourceType.BIGQUERY.

Questo metodo è disponibile solo per le origini dati BigQuery.

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

Parametri

NomeTipoDescrizione
parameterNameStringIl nome del parametro.
sourceCellStringLa cella di origine, come specificato nella notazione A1.

Invio

DataSourceSpecBuilder - Lo strumento di creazione, per il concatenamento.