Class 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 spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
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