이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class DataSourceSpecBuilder

DataSourceSpec의 빌더입니다. 특정 유형의 사양을 만들려면 as...() 메서드를 사용합니다. 새 빌더를 만들려면 SpreadsheetApp.newDataSourceSpec()를 사용합니다. 사양을 사용하려면 DataSourceTable를 참고하세요.

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

이 예에서는 BigQuery 데이터 소스 사양을 빌드하는 방법을 보여줍니다.

const spec = SpreadsheetApp.newDataSourceSpec()
                 .asBigQuery()
                 .setProjectId('big_query_project')
                 .setRawQuery('select @FIELD from table limit @LIMIT')
                 .setParameterFromCell('FIELD', 'Sheet1!A1')
                 .setParameterFromCell('LIMIT', 'namedRangeCell')
                 .build();

이 예에서는 Looker 데이터 소스 사양을 빌드하는 방법을 보여줍니다. build()를 사용한 후 LookerDataSourceSpec 객체를 반환합니다.

const spec = SpreadsheetApp.newDataSourceSpec()
                 .asLooker()
                 .setInstanceUrl('https://looker_instance_url.com')
                 .setModelName('model_name')
                 .setExploreName('explore_name')
                 .build();

메서드

메서드	반환 유형	간략한 설명
`asBigQuery()`	`BigQueryDataSourceSpecBuilder`	BigQuery 데이터 소스의 빌더를 가져옵니다.
`asLooker()`	`LookerDataSourceSpecBuilder`	Looker 데이터 소스의 빌더를 가져옵니다.
`build()`	`DataSourceSpec`	이 빌더의 설정에서 데이터 소스 사양을 빌드합니다.
`copy()`	`DataSourceSpecBuilder`	이 데이터 소스의 설정을 기반으로 `DataSourceSpecBuilder`를 만듭니다.
`getParameters()`	`DataSourceParameter[]`	데이터 소스의 매개변수를 가져옵니다.
`getType()`	`DataSourceType`	데이터 소스의 유형을 가져옵니다.
`removeAllParameters()`	`DataSourceSpecBuilder`	모든 매개변수를 삭제합니다.
`removeParameter(parameterName)`	`DataSourceSpecBuilder`	지정된 매개변수를 삭제합니다.
`setParameterFromCell(parameterName, sourceCell)`	`DataSourceSpecBuilder`	매개변수를 추가하거나 이름이 지정된 매개변수가 있는 경우 `DataSourceType.BIGQUERY` 유형의 데이터 소스 사양 빌더의 소스 셀을 업데이트합니다.

자세한 문서

`asBigQuery()`

BigQuery 데이터 소스의 빌더를 가져옵니다.

리턴

BigQueryDataSourceSpecBuilder: BigQuery 데이터 소스 사양 빌더입니다.

`asLooker()`

Looker 데이터 소스의 빌더를 가져옵니다.

const spec = SpreadsheetApp.newDataSourceSpec()
                 .asLooker()
                 .setInstanceUrl('https://looker_instance_url.com')
                 .setModelName('model_name')
                 .setExploreName('explore_name')
                 .build();

리턴

LookerDataSourceSpecBuilder: Looker 데이터 소스 사양 작성 도구입니다.

`build()`

이 빌더의 설정에서 데이터 소스 사양을 빌드합니다. 빌드하기 전에 as...()를 사용하여 데이터 소스 유형을 지정해야 합니다.

다음 코드 샘플은 BigQuery DataSource 사양을 빌드합니다.

const bigQueryDataSourceSpec = SpreadsheetApp.newDataSourceSpec().asBigQuery();
// TODO(developer): Replace with the required dataset, project and table IDs.
bigQueryDataSourceSpec.setDatasetId('my data set id');
bigQueryDataSourceSpec.setProjectId('my project id');
bigQueryDataSourceSpec.setTableId('my table id');

bigQueryDataSourceSpec.build();

다음 코드 샘플은 Looker DataSource 사양을 빌드합니다.

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();
const lookerSpec = lookerDataSourceSpecBuilder.setExploreName('my explore name')
                       .setInstanceUrl('my instance url')
                       .setModelName('my model name')
                       .build();

리턴

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

`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: 데이터 소스 유형입니다.

`removeAllParameters()`

모든 매개변수를 삭제합니다.

const specBuilder = SpreadsheetApp.newDataSourceSpec();
specBuilder.removeAllParameters();

리턴

DataSourceSpecBuilder: 연결을 위한 빌더입니다.

`removeParameter(parameterName)`

지정된 매개변수를 삭제합니다.

const specBuilder = SpreadsheetApp.newDataSourceSpec();
specBuilder.removeParameter('x');

매개변수

이름	유형	설명
`parameterName`	`String`	삭제할 매개변수의 이름입니다.

리턴

DataSourceSpecBuilder: 연결을 위한 빌더입니다.

`setParameterFromCell(parameterName, sourceCell)`

매개변수를 추가하거나 이름이 지정된 매개변수가 있는 경우 DataSourceType.BIGQUERY 유형의 데이터 소스 사양 빌더의 소스 셀을 업데이트합니다.

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

const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery();
specBuilder.setParameterFromCell('x', 'A1');
const bigQuerySpec = specBuilder.build();

매개변수

이름	유형	설명
`parameterName`	`String`	매개변수 이름입니다.
`sourceCell`	`String`	A1 표기법으로 지정된 소스 셀입니다.

리턴

DataSourceSpecBuilder: 연결을 위한 빌더입니다.