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 डेटा सोर्स स्पेसिफ़िकेशन बनाया जाता है.

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 डेटा सोर्स स्पेसिफ़िकेशन बनाया गया है.

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 — यह बिल्डर, चेन बनाने के लिए होता है.