Esta página foi traduzida pela API Cloud Translation.

Class DataSourceSpec

Acesse as configurações gerais de uma especificação de fonte de dados existente. Para acessar a especificação de uma fonte de dados de determinado tipo, use o método as...(). Para criar uma nova especificação de fonte de dados, use SpreadsheetApp.newDataSourceSpec().

Use essa classe apenas com dados conectados a um banco de dados.

Este exemplo mostra como receber informações de uma especificação de fonte de dados do 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());
}

Este exemplo mostra como receber informações de uma especificação de fonte de dados do Looker. O uso de asLooker() retorna um objeto 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étodos

Método	Tipo de retorno	Breve descrição
`asBigQuery()`	`BigQueryDataSourceSpec`	Extrai a especificação da fonte de dados do BigQuery.
`asLooker()`	`LookerDataSourceSpec`	Recebe a especificação da fonte de dados do Looker.
`copy()`	`DataSourceSpecBuilder`	Cria uma `DataSourceSpecBuilder` com base nas configurações da fonte de dados.
`getParameters()`	`DataSourceParameter[]`	Recebe os parâmetros da fonte de dados.
`getType()`	`DataSourceType`	Recebe o tipo da fonte de dados.

Documentação detalhada

`asBigQuery()`

Extrai a especificação da fonte de dados do BigQuery.

Retornar

BigQueryDataSourceSpec: especificação da fonte de dados do BigQuery.

`asLooker()`

Recebe a especificação da fonte de dados do 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();

Retornar

LookerDataSourceSpec: a especificação da fonte de dados do Looker.

`copy()`

Cria uma DataSourceSpecBuilder com base nas configurações da fonte de dados.

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

Retornar

DataSourceSpecBuilder: o builder.

`getParameters()`

Recebe os parâmetros da fonte de dados.

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

Esse método está disponível apenas para fontes de dados do BigQuery.

Retornar

DataSourceParameter[]: a lista de parâmetros.

`getType()`

Recebe o tipo da fonte de dados.

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

Retornar

DataSourceType: o tipo de origem de dados.