أداة إنشاء DataSourceSpec
. لإنشاء مواصفات لنوع معيّن، استخدِم الطريقة as...()
. لإنشاء أداة إنشاء جديدة، استخدِم SpreadsheetApp.newDataSourceSpec()
. لاستخدام المواصفات، يمكنك الاطّلاع على DataSourceTable
.
لا تستخدِم هذه الفئة إلا مع البيانات المرتبطة بقاعدة بيانات.
توضِّح هذه الأمثلة كيفية إنشاء مواصفات مصدر بيانات BigQuery.
var spec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('big_query_project') .setRawQuery('select @FIELD from table limit @LIMIT') .setParameterFromCell('FIELD', 'Sheet1!A1') .setParameterFromCell('LIMIT', 'namedRangeCell') .build();
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
asBigQuery() | BigQueryDataSourceSpecBuilder | الحصول على أداة إنشاء مصدر بيانات BigQuery |
build() | DataSourceSpec | تنشئ مواصفات مصدر البيانات من الإعدادات في أداة الإنشاء هذه. |
copy() | DataSourceSpecBuilder | تنشئ DataSourceSpecBuilder استنادًا إلى إعدادات مصدر البيانات هذا. |
getParameters() | DataSourceParameter[] | تحصل على مَعلمات مصدر البيانات. |
getType() | DataSourceType | الحصول على نوع مصدر البيانات. |
removeAllParameters() | DataSourceSpecBuilder | إزالة جميع المعلمات. |
removeParameter(parameterName) | DataSourceSpecBuilder | يزيل المعلمة المحددة. |
setParameterFromCell(parameterName, sourceCell) | DataSourceSpecBuilder | إضافة مَعلمة، أو في حال توفُّر المَعلمة التي تحمل الاسم، يتم تعديل خلية المصدر الخاصة بها |
الوثائق التفصيلية
asBigQuery()
الحصول على أداة إنشاء مصدر بيانات BigQuery
الإرجاع
BigQueryDataSourceSpecBuilder
— أداة إنشاء مواصفات مصادر بيانات BigQuery.
build()
تنشئ مواصفات مصدر البيانات من الإعدادات في أداة الإنشاء هذه. يجب استخدام as...()
لتحديد نوع مصدر البيانات قبل إنشاءه.
الإرجاع
DataSourceSpec
— مواصفات مصدر البيانات
copy()
تنشئ DataSourceSpecBuilder
استنادًا إلى إعدادات مصدر البيانات هذا.
الإرجاع
DataSourceSpecBuilder
— أداة الإنشاء
getParameters()
getType()
removeAllParameters()
removeParameter(parameterName)
يزيل المعلمة المحددة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
parameterName | String | اسم المَعلمة المطلوب إزالتها |
الإرجاع
DataSourceSpecBuilder
— أداة الإنشاء للسلاسل
setParameterFromCell(parameterName, sourceCell)
إضافة مَعلمة، أو في حال توفُّر المَعلمة التي تحمل الاسم، يتم تعديل خلية المصدر الخاصة بها
المعلمات
الاسم | النوع | الوصف |
---|---|---|
parameterName | String | اسم المَعلمة |
sourceCell | String | خلية المصدر، كما هو محدّد في الترميز A1. |
الإرجاع
DataSourceSpecBuilder
— أداة الإنشاء للسلاسل