أداة إنشاء 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)
لإزالة المعلَمة المحدّدة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
parameterName | String | اسم المَعلمة المطلوب إزالتها. |
استرجاع الكرة
DataSourceSpecBuilder
— أداة إنشاء السلاسل
setParameterFromCell(parameterName, sourceCell)
تضيف معلَمة، أو في حال وجود المَعلمة التي تحمل الاسم، يتم تعديل الخلية المصدر الخاصة بها.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
parameterName | String | اسم المَعلمة. |
sourceCell | String | الخلية المصدر، كما هو محدّد في تدوين A1. |
استرجاع الكرة
DataSourceSpecBuilder
— أداة إنشاء السلاسل