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 डेटा सोर्स के लिए उपलब्ध है.

पैरामीटर

नाम	टाइप	ब्यौरा
name	String	कैलकुलेट किए गए कॉलम का नाम.
formula	String	कैलकुलेट किए गए कॉलम का फ़ॉर्मूला.

वापसी का टिकट

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)

यह फ़ंक्शन, डेटा सोर्स में मौजूद उस कॉलम को दिखाता है जो कॉलम के नाम से मेल खाता है.

पैरामीटर

नाम	टाइप	ब्यौरा
columnName	String	कैलकुलेट किए गए उस कॉलम का नाम जिसे आपको चाहिए.

वापसी का टिकट

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() तरीकों का इस्तेमाल करें.

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

पैरामीटर

नाम	टाइप	ब्यौरा
spec	DataSourceSpec	डेटा सोर्स की जानकारी, जिसे अपडेट करना है.

वापसी का टिकट

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

अनुमति देना

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

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

---

updateSpec(spec, refreshAllLinkedObjects)

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

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

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

---

waitForAllDataExecutionsCompletion(timeoutInSeconds)

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

पैरामीटर

नाम	टाइप	ब्यौरा
timeoutInSeconds	Integer	डेटा प्रोसेस होने में लगने वाला समय, सेकंड में. यह अवधि ज़्यादा से ज़्यादा 300 सेकंड हो सकती है.

अनुमति देना

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

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