मौजूदा डेटा सोर्स टेबल को ऐक्सेस करें और उसमें बदलाव करें. नई शीट पर डेटा सोर्स की नई टेबल बनाने के लिए,
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()
देखें.
डेटा सोर्स का टाइप चालू न होने पर, अपवाद लागू होता है. किसी डेटा सोर्स का डेटा प्रोसेस करने के लिए, SpreadsheetApp#enable...Execution()
तरीके का इस्तेमाल करें
टाइप करें.
वापसी का टिकट
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()
से ज़्यादा प्राथमिकता दी जाती है.
डेटा सोर्स का टाइप चालू न होने पर, अपवाद लागू होता है. किसी डेटा सोर्स का डेटा प्रोसेस करने के लिए, SpreadsheetApp#enable...Execution()
तरीके का इस्तेमाल करें
टाइप करें.
वापसी का टिकट
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