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