Questa pagina è stata tradotta dall'API Cloud Translation.

Class DataSourceSpecBuilder

Lo sviluppatore di 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.

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 l'utilizzo di 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 generatore per l'origine dati BigQuery.
`asLooker()`	`LookerDataSourceSpecBuilder`	Recupera il generatore per l'origine dati di Looker.
`build()`	`DataSourceSpec`	Genera 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`	Recupera 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 relativa cella di origine per i generatori di specifiche dell'origine dati di tipo `DataSourceType.BIGQUERY`.

Documentazione dettagliata

`asBigQuery()`

Recupera il generatore per l'origine dati BigQuery.

Invio

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

`asLooker()`

Recupera il generatore per l'origine dati di Looker.

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

Invio

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

`build()`

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

Il seguente esempio di codice genera 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 genera una specifica dell'origine dati Looker.

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();
const 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 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();

Invio

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.

Invio

DataSourceParameter[]: l'elenco dei parametri.

`getType()`

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

Invio

DataSourceType: il tipo di origine dati.

`removeAllParameters()`

Rimuove tutti i parametri.

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

Invio

DataSourceSpecBuilder: il generatore, per l'accodamento.

`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.

Invio

DataSourceSpecBuilder: il generatore, per l'accodamento.

`setParameterFromCell(parameterName, sourceCell)`

Aggiunge un parametro oppure, se il parametro con il nome esiste, aggiorna la relativa 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.

Invio

DataSourceSpecBuilder: il generatore, per l'accodamento.