इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class DataSourceTable

मौजूदा डेटा सोर्स टेबल को ऐक्सेस करें और उसमें बदलाव करें. नई शीट पर डेटा सोर्स की नई टेबल बनाने के लिए, Spreadsheet.insertSheetWithDataSourceTable(spec) का इस्तेमाल करें.

इस क्लास का इस्तेमाल सिर्फ़ BigQuery डेटा सोर्स के साथ करें.

इस उदाहरण में, डेटा सोर्स की नई टेबल बनाने का तरीका बताया गया है.

SpreadsheetApp.enableBigQueryExecution();
var spreadsheet = SpreadsheetApp.getActive();
var spec = SpreadsheetApp.newDataSourceSpec()
           .asBigQuery()
           .setProjectId('big_query_project')
           .setRawQuery('select @FIELD from table limit @LIMIT')
           .setParameterFromCell('FIELD', 'Sheet1!A1')
           .setParameterFromCell('LIMIT', 'namedRangeCell')
           .build();
// Starts data execution asynchronously.
var dataSheet = spreadsheet.insertSheetWithDataSourceTable(spec);
var dataSourceTable = dataSheet.getDataSourceTables()[0];
// waitForCompletion() blocks script execution until data execution completes.
dataSourceTable.waitForCompletion(60);
// Check status after execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());

इस उदाहरण में, डेटा सोर्स में बदलाव करने का तरीका बताया गया है.

SpreadsheetApp.enableBigQueryExecution();
var dataSheet = SpreadsheetApp.getActive().getSheetByName("Data Sheet 1");
var dataSourceTable = dataSheet.getDataSourceTables()[0];
var dataSource = dataSourceTable.getDataSource();
var newSpec = dataSource.getSpec()
              .copy()
              .asBigQuery()
              .setRawQuery('select name from table limit 2')
              .removeAllParameters()
              .build();
// Updates data source specification and starts data execution asynchronously.
dataSource.updateSpec(newSpec);
// Check status during execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());
// waitForCompletion() blocks script execution until data execution completes.
dataSourceTable.waitForCompletion(60);
// Check status after execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
`addColumns(columnNames)`	`DataSourceTable`	डेटा सोर्स की टेबल में कॉलम जोड़ता है.
`addFilter(columnName, filterCriteria)`	`DataSourceTable`	डेटा सोर्स की टेबल पर लागू किया गया फ़िल्टर जोड़ता है.
`addSortSpec(columnName, ascending)`	`DataSourceTable`	डेटा सोर्स टेबल में किसी कॉलम पर, क्रम से लगाने की जानकारी जोड़ता है.
`addSortSpec(columnName, sortOrder)`	`DataSourceTable`	डेटा सोर्स की टेबल के कॉलम में, क्रम से लगाने की खास जानकारी जोड़ता है.
`cancelDataRefresh()`	`DataSourceTable`	अगर यह ऑब्जेक्ट अभी चल रहा है, तो इससे जुड़ा डेटा रीफ़्रेश रद्द हो जाता है.
`forceRefreshData()`	`DataSourceTable`	मौजूदा स्थिति पर ध्यान दिए बिना, इस ऑब्जेक्ट का डेटा रीफ़्रेश करता है.
`getColumns()`	`DataSourceTableColumn[]`	इसकी मदद से, डेटा सोर्स की टेबल में जोड़े गए सभी डेटा सोर्स कॉलम को अपनी पसंद के हिसाब से बनाया जा सकता है.
`getDataSource()`	`DataSource`	उस डेटा सोर्स को फ़ेच करता है जिससे ऑब्जेक्ट लिंक किया गया है.
`getFilters()`	`DataSourceTableFilter[]`	यह फ़ंक्शन डेटा सोर्स की टेबल पर लगाए गए सभी फ़िल्टर दिखाता है.
`getRange()`	`Range`	इस डेटा सोर्स की टेबल में `Range` की जानकारी मिलती है.
`getRowLimit()`	`Integer`	यह फ़ंक्शन डेटा सोर्स की टेबल के लिए, लाइन की सीमा दिखाता है.
`getSortSpecs()`	`SortSpec[]`	डेटा सोर्स की टेबल में, क्रम से लगाने से जुड़ी सभी खास जानकारी देता है.
`getStatus()`	`DataExecutionStatus`	इससे ऑब्जेक्ट का डेटा प्रोसेस होने के स्टेटस की जानकारी मिलती है.
`isSyncingAllColumns()`	`Boolean`	यह दिखाता है कि डेटा सोर्स टेबल, संबंधित डेटा सोर्स के सभी कॉलम सिंक कर रही है या नहीं.
`refreshData()`	`DataSourceTable`	ऑब्जेक्ट का डेटा रीफ़्रेश करता है.
`removeAllColumns()`	`DataSourceTable`	डेटा सोर्स टेबल के सभी कॉलम हटा देता है.
`removeAllSortSpecs()`	`DataSourceTable`	डेटा सोर्स की टेबल में, क्रम से लगाने से जुड़ी सभी खास जानकारी हटा देता है.
`setRowLimit(rowLimit)`	`DataSourceTable`	डेटा सोर्स की टेबल के लिए, लाइन की सीमा को अपडेट करता है.
`syncAllColumns()`	`DataSourceTable`	इससे जुड़े डेटा सोर्स के सभी मौजूदा और बाद में बनने वाले कॉलम को डेटा सोर्स की टेबल के साथ सिंक करें.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	मौजूदा एक्ज़ीक्यूशन पूरा होने तक इंतज़ार करता है. यह तय समय के बाद टाइम आउट हो जाता है.

विस्तृत दस्तावेज़

`addColumns(columnNames)`

डेटा सोर्स की टेबल में कॉलम जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
`columnNames`	`String[]`	जोड़े जाने वाले कॉलम के नामों की सूची.

वापसी का टिकट

DataSourceTable — चेन बनाने के लिए डेटा सोर्स की टेबल.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addFilter(columnName, filterCriteria)`

डेटा सोर्स की टेबल पर लागू किया गया फ़िल्टर जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
`columnName`	`String`	उस कॉलम का नाम जिस पर यह फ़िल्टर लागू करना है.
`filterCriteria`	`FilterCriteria`	लागू किए जाने वाले फ़िल्टर मानदंड.

वापसी का टिकट

DataSourceTable — चेन बनाने के लिए डेटा सोर्स की टेबल.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addSortSpec(columnName, ascending)`

डेटा सोर्स की टेबल के कॉलम में, क्रम से लगाने की खास जानकारी जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
`columnName`	`String`	क्रम से लगाने के लिए कॉलम का नाम.
`ascending`	`Boolean`	अगर `true` है, तो कॉलम को बढ़ते क्रम में लगाएं. अगर `false` है, तो कॉलम को घटते क्रम में लगाएं.

वापसी का टिकट

DataSourceTable — चेन बनाने के लिए डेटा सोर्स शीट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addSortSpec(columnName, sortOrder)`

डेटा सोर्स टेबल में किसी कॉलम पर, क्रम से लगाने की जानकारी जोड़ता है.

पैरामीटर

नाम	टाइप	ब्यौरा
`columnName`	`String`	क्रम से लगाने के लिए कॉलम का नाम.
`sortOrder`	`SortOrder`	क्रम से लगाने का क्रम.

वापसी का टिकट

DataSourceTable — चेन बनाने के लिए डेटा सोर्स शीट.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`cancelDataRefresh()`

अगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश फ़िलहाल चल रहा है, तो उसे रद्द कर देता है.

इस उदाहरण में फ़ॉर्मूला रीफ़्रेश होने को रद्द करने का तरीका बताया गया है.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

डेटा सोर्स का टाइप चालू न होने पर, अपवाद लागू होता है. किसी डेटा सोर्स का डेटा प्रोसेस करने के लिए, SpreadsheetApp#enable...Execution() तरीके का इस्तेमाल करें टाइप करें.

वापसी का टिकट

DataSourceTable — डेटा ऑब्जेक्ट.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`forceRefreshData()`

मौजूदा स्थिति पर ध्यान दिए बिना, इस ऑब्जेक्ट का डेटा रीफ़्रेश करता है. इनके लिए refreshData() देखें देखें. अगर आपको इस ऑब्जेक्ट के हाल ही में हो रहे रीफ़्रेश को रद्द करना है, तो cancelDataRefresh() देखें.

वापसी का टिकट

DataSourceTable — डेटा ऑब्जेक्ट.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumns()`

इसकी मदद से, डेटा सोर्स की टेबल में जोड़े गए सभी डेटा सोर्स कॉलम को अपनी पसंद के हिसाब से बनाया जा सकता है.

वापसी का टिकट

DataSourceTableColumn[] — डेटा सोर्स में मौजूद टेबल के कॉलम की सूची.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSource()`

उस डेटा सोर्स को फ़ेच करता है जिससे ऑब्जेक्ट लिंक किया गया है.

वापसी का टिकट

DataSource — डेटा सोर्स.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFilters()`

यह फ़ंक्शन डेटा सोर्स की टेबल पर लगाए गए सभी फ़िल्टर दिखाता है.

वापसी का टिकट

DataSourceTableFilter[] — डेटा सोर्स टेबल पर लागू किए गए सभी फ़िल्टर का कलेक्शन.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange()`

इस डेटा सोर्स की टेबल में Range की जानकारी मिलती है.

वापसी का टिकट

Range — रेंज.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowLimit()`

यह फ़ंक्शन डेटा सोर्स की टेबल के लिए, लाइन की सीमा दिखाता है.

वापसी का टिकट

Integer — डेटा सोर्स टेबल के लिए लाइन की सीमा या अगर कोई सीमा सेट नहीं है, तो null और टेबल में, Google Sheets के यूज़र इंटरफ़ेस (यूआई) के हिसाब से डिफ़ॉल्ट सीमा का इस्तेमाल किया जाता है.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSortSpecs()`

डेटा सोर्स टेबल में, क्रम से लगाने की सभी खास बातें पाता है.

वापसी का टिकट

SortSpec[] — क्रम से लगाने से जुड़ी जानकारी की सूची.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getStatus()`

इससे ऑब्जेक्ट का डेटा प्रोसेस होने के स्टेटस की जानकारी मिलती है.

वापसी का टिकट

DataExecutionStatus — डेटा प्रोसेस होने की स्थिति.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isSyncingAllColumns()`

यह दिखाता है कि डेटा सोर्स टेबल, संबंधित डेटा सोर्स के सभी कॉलम सिंक कर रही है या नहीं.

वापसी का टिकट

Boolean — True: अगर डेटा सोर्स की टेबल, संबंधित डेटा के सभी कॉलम सिंक कर रही है स्रोत से या फिर false से.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshData()`

ऑब्जेक्ट का डेटा रीफ़्रेश करता है.

अगर अभी error स्थिति में है, तो अपवाद देता है. स्पेसिफ़िकेशन अपडेट करने के लिए, DataSource#updateSpec() का इस्तेमाल करें. तरीका है डेटा सोर्स में अनचाहे बदलावों को रोकने के लिए, forceRefreshData() से ज़्यादा प्राथमिकता दी जाती है.

वापसी का टिकट

DataSourceTable — डेटा ऑब्जेक्ट.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeAllColumns()`

डेटा सोर्स टेबल के सभी कॉलम हटा देता है.

वापसी का टिकट

DataSourceTable — चेन करने के लिए डेटा सोर्स टेबल.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeAllSortSpecs()`

डेटा सोर्स की टेबल में, क्रम से लगाने से जुड़ी सभी खास जानकारी हटा देता है.

वापसी का टिकट

DataSourceTable — चेन करने के लिए डेटा सोर्स शीट.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowLimit(rowLimit)`

डेटा सोर्स की टेबल के लिए, लाइन की सीमा को अपडेट करता है. अगर पंक्ति की दी गई सीमा null है, तो इसके बाद, डेटा सोर्स की टेबल को अपडेट किया जाता है, ताकि Google Sheets के यूज़र इंटरफ़ेस (यूआई) में लाइन की डिफ़ॉल्ट सीमा का इस्तेमाल किया जा सके.

पैरामीटर

नाम	टाइप	ब्यौरा
`rowLimit`	`Integer`	डेटा टेबल के लिए, नई लाइन की सीमा. अगर यह `null` है, तो इस्तेमाल करने के लिए टेबल को अपडेट कर देता है पंक्ति की डिफ़ॉल्ट सीमा.

वापसी का टिकट

DataSourceTable — चेन बनाने के लिए डेटा सोर्स की टेबल.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`syncAllColumns()`

इससे जुड़े डेटा सोर्स के सभी मौजूदा और बाद में बनने वाले कॉलम को डेटा सोर्स की टेबल के साथ सिंक करें.

वापसी का टिकट

DataSourceTable — चेन बनाने के लिए डेटा सोर्स की टेबल.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForCompletion(timeoutInSeconds)`

मौजूदा एक्ज़ीक्यूशन के पूरा होने तक इंतज़ार करता है. दिए गए सेकंड में, समय खत्म हो जाता है. अगर समय खत्म होने पर निष्पादन पूरा नहीं होता है, तो अपवाद देता है, लेकिन डेटा प्रोसेस करना.

पैरामीटर

नाम	टाइप	ब्यौरा
`timeoutInSeconds`	`Integer`	डेटा प्रोसेस होने तक इंतज़ार का समय (सेकंड में). ज़्यादा से ज़्यादा 300 वर्ण हो सकते हैं सेकंड.

वापसी का टिकट

DataExecutionStatus — डेटा प्रोसेस होने की स्थिति.

अनुमति देना

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets