Accedi e modifica l'origine dati esistente. Per creare una tabella di origini dati con una nuova origine dati, consulta
Data
.
Utilizza questa classe solo con dati collegati a un database.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
cancel | void | Annullerà tutti gli aggiornamenti attualmente in esecuzione degli oggetti dell'origine dati collegati a questa origine dati. |
create | Data | Crea una colonna calcolata. |
create | Data | Crea una tabella pivot dell'origine dati nella prima cella di un nuovo foglio. |
create | Data | Crea una tabella dell'origine dati da questa origine dati nella prima cella di un nuovo foglio. |
get | Data | Restituisce la colonna calcolata nell'origine dati che corrisponde al nome della colonna. |
get | Data | Restituisce tutte le colonne calcolate nell'origine dati. |
get | Data | Restituisce tutte le colonne dell'origine dati. |
get | Data | Restituisce i fogli dell'origine dati associati a questa origine dati. |
get | Data | Recupera la specifica dell'origine dati. |
refresh | void | Aggiorna tutti gli oggetti dell'origine dati collegati all'origine dati. |
update | Data | Aggiorna la specifica dell'origine dati e aggiorna gli oggetti dell'origine dati collegati a questa origine dati con la nuova specifica. |
update | Data | Aggiorna la specifica dell'origine dati e aggiorna data
source sheets collegato con la nuova specifica. |
wait | void | Attende il completamento di tutte le esecuzioni correnti degli oggetti delle origini dati collegate e termina con un timeout dopo il numero di secondi specificato. |
Documentazione dettagliata
cancel All Linked Data Source Object Refreshes()
Annullerà tutti gli aggiornamenti attualmente in esecuzione degli oggetti dell'origine dati collegati a questa origine dati.
Questo esempio mostra come annullare tutti gli aggiornamenti di un'origine dati.
SpreadsheetApp .enableBigQueryExecution(); const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const dataSource = spreadsheet.getDataSources()[0]; dataSource.cancelAllLinkedDataSourceObjectRefreshes();
Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi Spreadsheet
per attivare l'esecuzione dei dati per il tipo di origine dati specifico.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Calculated Column(name, formula)
Crea una colonna calcolata. Questo metodo è disponibile solo per le origini dati BigQuery.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome della colonna calcolata. |
formula | String | La formula della colonna calcolata. |
Invio
Data
: la colonna calcolata appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Data Source Pivot Table On New Sheet()
Crea una tabella pivot dell'origine dati nella prima cella di un nuovo foglio. Come effetto collaterale, il nuovo foglio diventa il foglio attivo.
Invio
Data
: la tabella pivot dell'origine dati appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Data Source Table On New Sheet()
Crea una tabella dell'origine dati da questa origine dati nella prima cella di un nuovo foglio. Come effetto collaterale, il nuovo foglio diventa il foglio attivo.
Questo metodo è disponibile solo per le origini dati BigQuery.
Invio
Data
: la tabella dell'origine dati appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Calculated Column By Name(columnName)
Restituisce la colonna calcolata nell'origine dati che corrisponde al nome della colonna.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
column | String | Il nome della colonna calcolata da ottenere. |
Invio
Data
: la colonna calcolata che corrisponde al nome della colonna o null
se non esiste una colonna calcolata di questo tipo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Calculated Columns()
Restituisce tutte le colonne calcolate nell'origine dati.
Le specifiche dell'origine dati di tipo Data
restituiscono un array vuoto.
Invio
Data
: un array di tutte le colonne calcolate nell'origine dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Columns()
Restituisce tutte le colonne dell'origine dati.
Invio
Data
: un array di tutti i Data
nell'origine dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Sheets()
Restituisce i fogli dell'origine dati associati a questa origine dati.
Invio
Data
: un array di fogli di origini dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Spec()
Recupera la specifica dell'origine dati.
Invio
Data
: la specifica dell'origine dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refresh All Linked Data Source Objects()
Aggiorna tutti gli oggetti dell'origine dati collegati all'origine dati.
Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi Spreadsheet
per attivare l'esecuzione dei dati per il tipo di origine dati specifico.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
update Spec(spec)
Aggiorna la specifica dell'origine dati e aggiorna gli oggetti dell'origine dati collegati a questa origine dati con la nuova specifica.
Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi Spreadsheet
per attivare l'esecuzione dei dati per il tipo di origine dati specifico.
Viene lanciata un'eccezione se il tipo di specifica dell'origine dati è diverso da quello dell'origine dati corrente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
spec | Data | La specifica dell'origine dati da aggiornare. |
Invio
Data
: l'origine dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
update Spec(spec, refreshAllLinkedObjects)
Aggiorna la specifica dell'origine dati e aggiorna data
source sheets
collegato con la nuova specifica.
Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi Spreadsheet
per attivare l'esecuzione dei dati per il tipo di origine dati specifico.
Viene lanciata un'eccezione se il tipo di specifica dell'origine dati è diverso da quello dell'origine dati corrente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
spec | Data | La specifica dell'origine dati da aggiornare. |
refresh | Boolean | Se true , vengono aggiornati anche tutti gli oggetti dell'origine dati
collegati a questa origine dati. |
Invio
Data
: l'origine dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
wait For All Data Executions Completion(timeoutInSeconds)
Attende il completamento di tutte le esecuzioni correnti degli oggetti delle origini dati collegate e termina con un timeout dopo il numero di secondi specificato. Genera un'eccezione se le esecuzioni non sono state completate al termine del timeout, ma non annulla le esecuzioni dei dati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
timeout | Integer | Il tempo di attesa per le esecuzioni dei dati, in secondi. Il valore massimo è 300 secondi. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets