Class DataSourceSpecBuilder

DataSourceSpecBuilder

Il builder per DataSourceSpec. Per creare una specifica per un determinato tipo, utilizza il metodo as...(). Per creare un nuovo builder, utilizza SpreadsheetApp.newDataSourceSpec(). Per utilizzare la specifica, vedi DataSourceTable.

Utilizza questa classe solo con i dati connessi a un database.

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

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

const 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	Recupera il builder per l'origine dati BigQuery.
asLooker()	LookerDataSourceSpecBuilder	Recupera il builder per l'origine dati di Looker.
build()	DataSourceSpec	Crea una specifica dell'origine dati dalle impostazioni di questo generatore.
copy()	DataSourceSpecBuilder	Crea un DataSourceSpecBuilder in base alle impostazioni di questa origine dati.
getParameters()	DataSourceParameter[]	Recupera 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 o, se il parametro con il nome esiste, aggiorna la cella di origine per i generatori di specifiche dell'origine dati di tipo DataSourceType.BIGQUERY.

Documentazione dettagliata

asBigQuery()

Recupera il builder per l'origine dati BigQuery.

Indietro

BigQueryDataSourceSpecBuilder: il generatore di specifiche dell'origine dati BigQuery.

---

asLooker()

Recupera il builder per l'origine dati di Looker.

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

Indietro

LookerDataSourceSpecBuilder: il generatore delle specifiche di origini dati di Looker.

---

build()

Crea una specifica dell'origine dati dalle impostazioni di questo generatore. Devi utilizzare as...() per specificare un tipo di origine dati prima della creazione.

Il seguente esempio di codice crea una specifica dell'origine dati 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();

Il seguente esempio di codice crea una specifica dell'origine dati di Looker.

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

Indietro

DataSourceSpec: la specifica dell'origine dati.

---

copy()

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

const newSpec = spec.copy();

Indietro

DataSourceSpecBuilder: il builder.

---

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

Questo metodo è disponibile solo per le origini dati BigQuery.

Indietro

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

Indietro

DataSourceType: il tipo di origine dati.

---

removeAllParameters()

Rimuove tutti i parametri.

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

Indietro

DataSourceSpecBuilder: il builder per il concatenamento.

---

removeParameter(parameterName)

Rimuove il parametro specificato.

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

Parametri

Nome	Tipo	Descrizione
parameterName	String	Il nome del parametro da rimuovere.

Indietro

DataSourceSpecBuilder: il builder per il concatenamento.

---

setParameterFromCell(parameterName, sourceCell)

Aggiunge un parametro o, se il parametro con il nome esiste, aggiorna la cella di origine per i generatori di specifiche dell'origine dati di tipo DataSourceType.BIGQUERY.

Questo metodo è disponibile solo per le origini dati BigQuery.

const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery();
specBuilder.setParameterFromCell('x', 'A1');
const bigQuerySpec = specBuilder.build();

Parametri

Nome	Tipo	Descrizione
parameterName	String	Il nome del parametro.
sourceCell	String	La cella di origine, come specificato nella notazione A1.

Indietro

DataSourceSpecBuilder: il builder per il concatenamento.