Class DataSource

DataSource

मौजूदा डेटा सोर्स ऐक्सेस करना और उसमें बदलाव करना. नए डेटा सोर्स के साथ डेटा सोर्स की टेबल बनाने के लिए, देखें DataSourceTable.

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
cancelAllLinkedDataSourceObjectRefreshes()voidइस डेटा सोर्स से जुड़े डेटा सोर्स ऑब्जेक्ट के, फ़िलहाल चल रहे सभी रीफ़्रेश रद्द कर देता है.
createCalculatedColumn(name, formula)DataSourceColumnकैलकुलेट किया गया कॉलम बनाता है.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTableइस डेटा सोर्स से, नई शीट की पहली सेल में डेटा सोर्स पिवट टेबल बनाता है.
createDataSourceTableOnNewSheet()DataSourceTableनई शीट की पहली सेल में, इस डेटा सोर्स का इस्तेमाल करके डेटा सोर्स टेबल बनाता है.
getCalculatedColumnByName(columnName)DataSourceColumnडेटा सोर्स में, कॉलम के नाम से मेल खाने वाला कॉलम दिखाता है.
getCalculatedColumns()DataSourceColumn[]डेटा सोर्स में, आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए सभी कॉलम दिखाता है.
getColumns()DataSourceColumn[]डेटा सोर्स में सभी कॉलम दिखाता है.
getDataSourceSheets()DataSourceSheet[]इस डेटा सोर्स से जुड़ी डेटा सोर्स शीट दिखाता है.
getSpec()DataSourceSpecइससे डेटा सोर्स की जानकारी मिलती है.
refreshAllLinkedDataSourceObjects()voidडेटा सोर्स से लिंक किए गए सभी डेटा सोर्स ऑब्जेक्ट रीफ़्रेश करता है.
updateSpec(spec)DataSourceयह डेटा सोर्स की जानकारी को अपडेट करता है और इससे लिंक किए गए डेटा सोर्स ऑब्जेक्ट को रीफ़्रेश करता है डेटा सोर्स में नई जानकारी जोड़ें.
updateSpec(spec, refreshAllLinkedObjects)DataSourceयह डेटा सोर्स की जानकारी को अपडेट करता है. साथ ही, लिंक किए गए data source sheets को नई जानकारी के साथ रीफ़्रेश करता है.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidलिंक किए गए डेटा सोर्स ऑब्जेक्ट के सभी मौजूदा एक्ज़ीक्यूशन के पूरा होने तक इंतज़ार करता है. साथ ही, दिए गए सेकंड के बाद टाइम आउट हो जाता है.

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

cancelAllLinkedDataSourceObjectRefreshes()

इस डेटा सोर्स से लिंक किए गए डेटा सोर्स ऑब्जेक्ट के सभी इस समय चल रहे रीफ़्रेश रद्द कर देता है.

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

SpreadsheetApp.enableBigQueryExecution();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

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

अनुमति देना

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

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

createCalculatedColumn(name, formula)

कैलकुलेटेड कॉलम बनाता है. यह तरीका सिर्फ़ BigQuery डेटा सोर्स के लिए उपलब्ध है.

पैरामीटर

नामटाइपब्यौरा
nameStringकैलकुलेटेड कॉलम का नाम.
formulaStringकैलकुलेटेड कॉलम का फ़ॉर्मूला.

वापसी का टिकट

DataSourceColumn — आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किया गया नया कॉलम.

अनुमति देना

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

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

createDataSourcePivotTableOnNewSheet()

यह डेटा सोर्स से नई शीट की पहली सेल में, डेटा सोर्स के लिए पिवट टेबल बनाता है. बतौर साइड इफ़ेक्ट की वजह से, नई शीट ऐक्टिव शीट बन जाती है.

वापसी का टिकट

DataSourcePivotTable — नई बनाई गई डेटा सोर्स पिवट टेबल.

अनुमति देना

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

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

createDataSourceTableOnNewSheet()

नई शीट की पहली सेल में, इस डेटा सोर्स का इस्तेमाल करके डेटा सोर्स टेबल बनाता है. एक साइड के तौर पर प्रभाव, नई शीट को सक्रिय शीट बनाता है.

यह तरीका सिर्फ़ BigQuery डेटा सोर्स के लिए उपलब्ध है.

वापसी का टिकट

DataSourceTable — नई डेटा सोर्स टेबल बनाई गई.

अनुमति देना

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

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

getCalculatedColumnByName(columnName)

डेटा सोर्स में, कॉलम के नाम से मेल खाने वाला कॉलम दिखाता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringआपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए कॉलम का नाम.

वापसी का टिकट

DataSourceColumn — कॉलम के नाम से मेल खाने वाला कैलकुलेटेड कॉलम या null, अगर ऐसा कोई कॉलम नहीं है कॉलम के आधार पर तैयार किया गया है.

अनुमति देना

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

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

getCalculatedColumns()

डेटा सोर्स में, आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए सभी कॉलम दिखाता है.

DataSourceType.LOOKER टाइप की डेटा सोर्स जानकारी से, खाली अरे मिलता है.

वापसी का टिकट

DataSourceColumn[] — डेटा सोर्स में, आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए सभी कॉलम का कलेक्शन.

अनुमति देना

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

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

getColumns()

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

वापसी का टिकट

DataSourceColumn[] — डेटा सोर्स में मौजूद सभी DataSourceColumn का कलेक्शन.

अनुमति देना

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

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

getDataSourceSheets()

इस डेटा सोर्स से जुड़ी डेटा सोर्स शीट दिखाता है.

वापसी का टिकट

DataSourceSheet[] — डेटा सोर्स की शीट का कलेक्शन.

अनुमति देना

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

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

getSpec()

डेटा सोर्स की जानकारी पाता है.

वापसी का टिकट

DataSourceSpec — डेटा सोर्स की जानकारी.

अनुमति देना

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

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

refreshAllLinkedDataSourceObjects()

डेटा सोर्स से लिंक किए गए सभी डेटा सोर्स ऑब्जेक्ट रीफ़्रेश करता है.

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

अनुमति देना

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

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

updateSpec(spec)

डेटा सोर्स स्पेसिफ़िकेशन को अपडेट करता है और इस डेटा सोर्स से लिंक किए गए डेटा सोर्स ऑब्जेक्ट को नए स्पेसिफ़िकेशन के साथ रीफ़्रेश करता है.

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

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

पैरामीटर

नामटाइपब्यौरा
specDataSourceSpecडेटा सोर्स की वे जानकारी जिन्हें अपडेट करना है.

वापसी का टिकट

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

अनुमति देना

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

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

updateSpec(spec, refreshAllLinkedObjects)

यह डेटा सोर्स की जानकारी को अपडेट करता है. साथ ही, लिंक किए गए data source sheets को नई जानकारी के साथ रीफ़्रेश करता है.

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

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

पैरामीटर

नामटाइपब्यौरा
specDataSourceSpecडेटा सोर्स की वे जानकारी जिन्हें अपडेट करना है.
refreshAllLinkedObjectsBooleanअगर true है, तो इस डेटा सोर्स से लिंक किए गए सभी डेटा सोर्स ऑब्जेक्ट को भी रीफ़्रेश करता है.

वापसी का टिकट

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

अनुमति देना

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

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

waitForAllDataExecutionsCompletion(timeoutInSeconds)

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

पैरामीटर

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

अनुमति देना

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

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