تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class DataSourceSpecBuilder

أداة إنشاء 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()`

الحصول على معلمات مصدر البيانات.

استرجاع الكرة

DataSourceParameter[] — قائمة المَعلمات

`getType()`

تحصل على نوع مصدر البيانات.

استرجاع الكرة

DataSourceType — نوع مصدر البيانات

`removeAllParameters()`

يزيل جميع المَعلمات.

استرجاع الكرة

DataSourceSpecBuilder — أداة إنشاء السلاسل

`removeParameter(parameterName)`

لإزالة المعلَمة المحدّدة.

المَعلمات

الاسم	Type	الوصف
`parameterName`	`String`	اسم المَعلمة المطلوب إزالتها.

استرجاع الكرة

DataSourceSpecBuilder — أداة إنشاء السلاسل

`setParameterFromCell(parameterName, sourceCell)`

تضيف معلَمة، أو في حال وجود المَعلمة التي تحمل الاسم، يتم تعديل الخلية المصدر الخاصة بها.

المَعلمات

الاسم	Type	الوصف
`parameterName`	`String`	اسم المَعلمة.
`sourceCell`	`String`	الخلية المصدر، كما هو محدّد في تدوين A1.

استرجاع الكرة

DataSourceSpecBuilder — أداة إنشاء السلاسل