Class DataSourceSpec

DataSourceSpec

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 source de données pour un certain type, utilisez la méthode as...(). Pour créer une spécification de source de données, utilisez SpreadsheetApp.newDataSourceSpec().

N'utilisez cette classe qu'avec des 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()BigQueryDataSourceSpecObtient la spécification de la source de données BigQuery.
asLooker()LookerDataSourceSpecObtient la spécification 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[]Obtient les paramètres de la source de données.
getType()DataSourceTypeObtient le type de source de données.

Documentation détaillée

asBigQuery()

Obtient la spécification de la source de données BigQuery.

Renvois

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

asLooker()

Obtient la spécification 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()

Obtient 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()

Obtient le type de 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.