تمت ترجمة هذه الصفحة بواسطة 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)`

يزيل المعلمة المحددة.

المعلمات

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

الإرجاع

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

`setParameterFromCell(parameterName, sourceCell)`

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

المعلمات

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

الإرجاع

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