Class DataSourceTable

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)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

addFilter(columnName, filterCriteria)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

addSortSpec(columnName, ascending)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

addSortSpec(columnName, sortOrder)

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

पैरामीटर

नामटाइपब्यौरा
columnNameStringक्रम से लगाने के लिए कॉलम का नाम.
sortOrderSortOrderक्रम से लगाने का क्रम.

वापसी का टिकट

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

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

वापसी का टिकट

BooleanTrue: अगर डेटा सोर्स की टेबल, संबंधित डेटा के सभी कॉलम सिंक कर रही है स्रोत से या फिर 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 के यूज़र इंटरफ़ेस (यूआई) में लाइन की डिफ़ॉल्ट सीमा का इस्तेमाल किया जा सके.

पैरामीटर

नामटाइपब्यौरा
rowLimitIntegerडेटा टेबल के लिए, नई लाइन की सीमा. अगर यह 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)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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