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
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
asBigQuery() | BigQueryDataSourceSpecBuilder | Ottiene il builder per l'origine dati BigQuery. |
asLooker() | LookerDataSourceSpecBuilder | Ottiene il generatore per l'origine dati di Looker. |
build() | DataSourceSpec | Crea una specifica dell'origine dati dalle impostazioni di questo builder. |
copy() | DataSourceSpecBuilder | Crea un valore DataSourceSpecBuilder in base alle impostazioni di questa origine dati. |
getParameters() | DataSourceParameter[] | Restituisce i parametri dell'origine dati. |
getType() | DataSourceType | Restituisce il tipo di origine dati. |
removeAllParameters() | DataSourceSpecBuilder | Rimuove tutti i parametri. |
removeParameter(parameterName) | DataSourceSpecBuilder | Rimuove il parametro specificato. |
setParameterFromCell(parameterName, sourceCell) | DataSourceSpecBuilder | 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 . |
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
Nome | Tipo | Descrizione |
---|---|---|
parameterName | String | Il 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
Nome | Tipo | Descrizione |
---|---|---|
parameterName | String | Il nome del parametro. |
sourceCell | String | La cella di origine, come specificato nella notazione A1. |
Invio
DataSourceSpecBuilder
- Lo strumento di creazione, per il concatenamento.