Class DataSource

DataSource

Accéder à une source de données existante et la modifier Pour créer une table de source de données avec une nouvelle source de données, consultez DataSourceTable

N'utilisez cette classe qu'avec des données connectées à une base de données.

Méthodes

MéthodeType renvoyéBrève description
cancelAllLinkedDataSourceObjectRefreshes()voidAnnule toutes les actualisations en cours d'exécution des objets de source de données associés à cette source de données.
createCalculatedColumn(name, formula)DataSourceColumnCrée une colonne de calcul.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTableCrée un tableau croisé dynamique de source de données à partir de cette source de données dans la première cellule d'une nouvelle feuille.
createDataSourceTableOnNewSheet()DataSourceTableCrée un tableau de source de données à partir de cette source dans la première cellule d'une nouvelle feuille.
getCalculatedColumnByName(columnName)DataSourceColumnRenvoie la colonne de calcul de la source de données qui correspond au nom de la colonne.
getCalculatedColumns()DataSourceColumn[]Renvoie toutes les colonnes de calcul de la source de données.
getColumns()DataSourceColumn[]Renvoie toutes les colonnes de la source de données.
getDataSourceSheets()DataSourceSheet[]Renvoie les feuilles de source de données associées à cette source de données.
getSpec()DataSourceSpecRécupère la spécification de la source de données.
refreshAllLinkedDataSourceObjects()voidActualise tous les objets de source de données associés à la source de données.
updateSpec(spec)DataSourceMet à jour la spécification de la source de données et actualise les objets de source de données qui lui sont associés source de données avec la nouvelle spécification.
updateSpec(spec, refreshAllLinkedObjects)DataSourceMet à jour la spécification de la source de données et actualise le data source sheets associé avec la nouvelle spécification.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidAttend que toutes les exécutions en cours des objets de source de données associés soient terminées, ce qui a pour effet d'expirer après le nombre de secondes indiqué.

Documentation détaillée

cancelAllLinkedDataSourceObjectRefreshes()

Annule toutes les actualisations en cours d'exécution des objets de source de données associés à cette source de données.

Cet exemple montre comment annuler toutes les actualisations d'une source de données.

SpreadsheetApp.enableBigQueryExecution();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

La fonction renvoie une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution() afin d'autoriser l'exécution des données spécifiques. le type de source.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

createCalculatedColumn(name, formula)

Crée une colonne de calcul. Cette méthode n'est disponible que pour les sources de données BigQuery.

Paramètres

NomTypeDescription
nameStringNom de la colonne de calcul.
formulaStringFormule de la colonne de calcul.

Renvois

DataSourceColumn : colonne de calcul nouvellement créée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

createDataSourcePivotTableOnNewSheet()

Crée un tableau croisé dynamique de source de données à partir de cette source de données dans la première cellule d'une nouvelle feuille. En tant que fait de la nouvelle feuille la feuille active.

Renvois

DataSourcePivotTable : tableau croisé dynamique de source de données nouvellement créé.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

createDataSourceTableOnNewSheet()

Crée un tableau de source de données à partir de cette source dans la première cellule d'une nouvelle feuille. En conséquence, la nouvelle feuille devient la feuille active.

Cette méthode n'est disponible que pour les sources de données BigQuery.

Renvois

DataSourceTable : table de source de données nouvellement créée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCalculatedColumnByName(columnName)

Renvoie la colonne de calcul de la source de données qui correspond au nom de la colonne.

Paramètres

NomTypeDescription
columnNameStringNom de la colonne de calcul à obtenir.

Renvois

DataSourceColumn : colonne de calcul qui correspond au nom de la colonne, ou null en l'absence de colonne de calcul.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCalculatedColumns()

Renvoie toutes les colonnes calculées de la source de données.

Les spécifications de la source de données de type DataSourceType.LOOKER renvoient un tableau vide.

Renvois

DataSourceColumn[] : tableau listant toutes les colonnes de calcul de la source de données.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getColumns()

Renvoie toutes les colonnes de la source de données.

Renvois

DataSourceColumn[] : tableau contenant tous les DataSourceColumn de la source de données.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSourceSheets()

Renvoie les feuilles de source de données associées à cette source de données.

Renvois

DataSourceSheet[] : tableau de feuilles de source de données.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSpec()

Récupère la spécification de la source de données.

Renvois

DataSourceSpec : spécification de la source de données.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

refreshAllLinkedDataSourceObjects()

Actualise tous les objets de source de données associés à la source de données.

La fonction renvoie une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution() afin d'autoriser l'exécution des données spécifiques. le type de source.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

updateSpec(spec)

Met à jour la spécification de la source de données et actualise les objets de source de données associés à cette source de données avec la nouvelle spécification.

La fonction renvoie une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution() pour activer l'exécution des données pour le type de source de données spécifique.

Génère une exception si le type de spécification de la source de données est différent du type de source de données actuel.

Paramètres

NomTypeDescription
specDataSourceSpecSpécification de la source de données à mettre à jour.

Renvois

DataSource : source de données.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

updateSpec(spec, refreshAllLinkedObjects)

Met à jour la spécification de la source de données et actualise l'data source sheets associée avec la nouvelle spécification.

La fonction renvoie une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution() afin d'autoriser l'exécution des données spécifiques. le type de source.

Génère une exception si le type de spécification de la source de données est différent du type de source de données actuel.

Paramètres

NomTypeDescription
specDataSourceSpecSpécification de la source de données à mettre à jour.
refreshAllLinkedObjectsBooleanSi la valeur est true, tous les objets de source de données sont également actualisés. associées à cette source de données.

Renvois

DataSource : source de données.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

waitForAllDataExecutionsCompletion(timeoutInSeconds)

Attend que toutes les exécutions en cours des objets de source de données associés soient terminées, ce qui a pour effet d'expirer après le nombre de secondes indiqué. Génère une exception si les exécutions ne sont pas terminées à l'expiration du délai, mais n'annule pas les exécutions de données.

Paramètres

NomTypeDescription
timeoutInSecondsIntegerDélai d'attente des exécutions de données, en secondes. Le maximum est de 300 secondes.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets