Class DataSourceSpec

Spécification de lasource de données

Accédez aux paramètres généraux d'une spécification de source de données existante. Pour accéder à la spécification de la source de données pour un type donné, utilisez la méthode as...(). Pour créer une spécification de source de données, utilisez SpreadsheetApp.newDataSourceSpec().

N'utilisez cette classe que pour les données connectées à une base de données.

Cet exemple montre comment obtenir des informations à partir d'une spécification de source de données BigQuery. 

const dataSourceTable = SpreadsheetApp.getActive()
                            .getSheetByName('Data Sheet 1')
                            .getDataSourceTables()[0];
const spec = dataSourceTable.getDataSource().getSpec();
if (spec.getType() === SpreadsheetApp.DataSourceType.BIGQUERY) {
  const bqSpec = spec.asBigQuery();
  Logger.log('Project ID: %s\n', bqSpec.getProjectId());
  Logger.log('Raw query string: %s\n', bqSpec.getRawQuery());
}

Cet exemple montre comment obtenir des informations à partir d'une spécification de source de données Looker. L'utilisation de asLooker() renvoie un objet LookerDataSourceSpec. 

// 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().asLooker();

if (spec.getType() === SpreadsheetApp.DataSourceType.LOOKER) {
  const lookerSpec = spec.asLooker();
  Logger.log('Looker instance URL: %s\n', lookerSpec.getInstanceUrl());
}

Méthodes

MéthodeType renvoyéBrève description
asBigQuery()BigQueryDataSourceSpecRécupère les spécifications de la source de données BigQuery.
asLooker()LookerDataSourceSpecRécupère les spécifications de la source de données Looker.
copy()DataSourceSpecBuilderCrée un DataSourceSpecBuilder en fonction des paramètres de cette source de données.
getParameters()DataSourceParameter[]Récupère les paramètres de la source de données.
getType()DataSourceTypeRécupère le type de la source de données.

Documentation détaillée

asBigQuery()

Récupère les spécifications de la source de données BigQuery.

Renvois

BigQueryDataSourceSpec : spécification de la source de données BigQuery.

asLooker()

Récupère les spécifications de la source de données Looker. 

// 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().asLooker();

Renvois

LookerDataSourceSpec : spécification de la source de données Looker.

copy()

Crée un DataSourceSpecBuilder en fonction des paramètres de cette source de données. 

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

Renvois

DataSourceSpecBuilder : le compilateur.

getParameters()

Récupère les paramètres de la source de données. 

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

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

Renvois

DataSourceParameter[] : liste des paramètres.

getType()

Récupère le type de la source de données. 

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

Renvois

DataSourceType : type de source de données.