Class DataSourceSpec

데이터소스사양

기존 데이터 소스 사양의 일반 설정에 액세스합니다. 특정 유형의 데이터 소스 사양에 액세스하려면 as...() 메서드를 사용하세요. 새 데이터 소스 사양을 만들려면 SpreadsheetApp.newDataSourceSpec()를 사용하세요.

이 클래스는 데이터베이스에 연결된 데이터에만 사용합니다.

이 예에서는 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());
}

이 예에서는 Looker 데이터 소스 사양에서 정보를 가져오는 방법을 보여줍니다. asLooker()를 사용하면 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());
}

메서드

메서드반환 유형간략한 설명
asBigQuery()BigQueryDataSourceSpecBigQuery 데이터 소스의 사양을 가져옵니다.
asLooker()LookerDataSourceSpecLooker 데이터 소스의 사양을 가져옵니다.
copy()DataSourceSpecBuilder이 데이터 소스의 설정을 기반으로 DataSourceSpecBuilder를 만듭니다.
getParameters()DataSourceParameter[]데이터 소스의 매개변수를 가져옵니다.
getType()DataSourceType데이터 소스의 유형을 가져옵니다.

자세한 문서

asBigQuery()

BigQuery 데이터 소스의 사양을 가져옵니다.

리턴

BigQueryDataSourceSpec: BigQuery 데이터 소스 사양입니다.

asLooker()

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

리턴

LookerDataSourceSpec: Looker 데이터 소스 사양입니다.

copy()

이 데이터 소스의 설정을 기반으로 DataSourceSpecBuilder를 만듭니다. 

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

리턴

DataSourceSpecBuilder: 빌더입니다.

getParameters()

데이터 소스의 매개변수를 가져옵니다. 

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

이 메서드는 BigQuery 데이터 소스에서만 사용할 수 있습니다.

리턴

DataSourceParameter[]: 매개변수 목록입니다.

getType()

데이터 소스의 유형을 가져옵니다. 

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

리턴

DataSourceType: 데이터 소스 유형입니다.