الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
build() | DataSourceSpec | تُنشئ هذه الأداة مواصفات مصدر بيانات من الإعدادات الواردة في أداة الإنشاء هذه. |
copy() | DataSourceSpecBuilder | تُنشئ DataSourceSpecBuilder استنادًا إلى إعدادات مصدر البيانات هذا. |
getDatasetId() | String | تحصل على رقم تعريف مجموعة بيانات BigQuery. |
getParameters() | DataSourceParameter[] | تحصل على مَعلمات مصدر البيانات. |
getProjectId() | String | للحصول على رقم تعريف مشروع الفوترة |
getRawQuery() | String | تحصل على سلسلة طلب البحث الأوّلية. |
getTableId() | String | تحصل على معرّف جدول BigQuery. |
getTableProjectId() | String | تحصل على رقم تعريف مشروع BigQuery للجدول. |
getType() | DataSourceType | تحصل على نوع مصدر البيانات. |
removeAllParameters() | BigQueryDataSourceSpecBuilder | تزيل جميع المَعلمات. |
removeParameter(parameterName) | BigQueryDataSourceSpecBuilder | تزيل المَعلمة المحدّدة. |
setDatasetId(datasetId) | BigQueryDataSourceSpecBuilder | تُستخدَم لضبط رقم تعريف مجموعة بيانات BigQuery. |
setParameterFromCell(parameterName, sourceCell) | BigQueryDataSourceSpecBuilder | تُضيف مَعلمة، أو إذا كانت المَعلمة التي تحمل الاسم متوفّرة، تعدّل خلية المصدر الخاصة ببنائي مواصفات مصدر البيانات من النوع DataSourceType.BIGQUERY . |
setProjectId(projectId) | BigQueryDataSourceSpecBuilder | لضبط رقم تعريف مشروع الفوترة في BigQuery |
setRawQuery(rawQuery) | BigQueryDataSourceSpecBuilder | تُستخدَم لضبط سلسلة طلب البحث الأوّلية. |
setTableId(tableId) | BigQueryDataSourceSpecBuilder | تُستخدَم لضبط معرّف جدول BigQuery. |
setTableProjectId(projectId) | BigQueryDataSourceSpecBuilder | تُستخدَم لضبط رقم تعريف مشروع BigQuery للجدول. |
مستندات تفصيلية
build()
تُنشئ هذه الأداة مواصفات مصدر بيانات من الإعدادات الواردة في أداة الإنشاء هذه. يجب استخدام as...()
لتحديد نوع مصدر بيانات قبل الإنشاء.
ينشئ نموذج التعليمات البرمجية التالي مواصفات مصدر بيانات BigQuery.
const bigQueryDataSourceSpec = SpreadsheetApp.newDataSourceSpec().asBigQuery(); // TODO(developer): Replace with the required dataset, project and table IDs. bigQueryDataSourceSpec.setDatasetId('my data set id'); bigQueryDataSourceSpec.setProjectId('my project id'); bigQueryDataSourceSpec.setTableId('my table id'); bigQueryDataSourceSpec.build();
ينشئ نموذج التعليمات البرمجية التالي مواصفات Looker DataSource.
const lookerDataSourceSpecBuilder = SpreadsheetApp.newDataSourceSpec().asLooker(); const lookerSpec = lookerDataSourceSpecBuilder.setExploreName('my explore name') .setInstanceUrl('my instance url') .setModelName('my model name') .build();
الإرجاع
DataSourceSpec
: مواصفات مصدر البيانات
copy()
تُنشئ DataSourceSpecBuilder
استنادًا إلى إعدادات مصدر البيانات هذا.
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const newSpec = spec.copy();
الإرجاع
DataSourceSpecBuilder
: صانع المحتوى
getDatasetId()
تحصل على رقم تعريف مجموعة بيانات BigQuery.
الإرجاع
String
: معرّف مجموعة البيانات، أو سلسلة فارغة إذا تم تحديد مواصفات مصدر البيانات من خلال طلب بحث أولي.
getParameters()
تحصل على مَعلمات مصدر البيانات.
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const parameters = spec.getParameters();
لا تتوفّر هذه الطريقة إلا لمصادر بيانات BigQuery.
الإرجاع
DataSourceParameter[]
- قائمة المَعلمات
getProjectId()
للحصول على رقم تعريف مشروع الفوترة
الإرجاع
String
- رقم تعريف المشروع
getRawQuery()
تحصل على سلسلة طلب البحث الأوّلية.
الإرجاع
String
: سلسلة طلب البحث الأوّلية
getTableId()
تحصل على معرّف جدول BigQuery.
الإرجاع
String
: رقم تعريف الجدول، أو سلسلة فارغة إذا تم تحديد مواصفات مصدر البيانات من خلال طلب بحث أولي.
getTableProjectId()
تحصل على رقم تعريف مشروع BigQuery للجدول.
الإرجاع
String
: رقم تعريف مشروع الجدول، أو سلسلة فارغة إذا تم تحديد مواصفات مصدر البيانات من خلال طلب بحث خام.
getType()
تحصل على نوع مصدر البيانات.
// TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); const spec = ss.getDataSources()[0].getSpec(); const type = spec.getType();
الإرجاع
DataSourceType
: نوع مصدر البيانات
removeAllParameters()
تزيل جميع المَعلمات.
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeAllParameters();
الإرجاع
BigQueryDataSourceSpecBuilder
— أداة الإنشاء لتسلسل العناصر
removeParameter(parameterName)
تزيل المَعلمة المحدّدة.
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeParameter('x');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
parameterName | String | اسم المَعلمة المطلوب إزالتها |
الإرجاع
BigQueryDataSourceSpecBuilder
— أداة الإنشاء، لإنشاء سلاسل.
setDatasetId(datasetId)
تُستخدَم لضبط رقم تعريف مجموعة بيانات BigQuery.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
datasetId | String | رقم تعريف مجموعة البيانات. |
الإرجاع
BigQueryDataSourceSpecBuilder
- هذا المُنشئ، لتسلسل العناصر.
setParameterFromCell(parameterName, sourceCell)
تُضيف مَعلمة، أو إذا كانت المَعلمة التي تحمل الاسم متوفّرة، تعدّل خلية المصدر الخاصة بأدوات إنشاء مواصفات مصدر البيانات من النوع DataSourceType.BIGQUERY
.
لا تتوفّر هذه الطريقة إلا لمصادر بيانات BigQuery.
const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery(); specBuilder.setParameterFromCell('x', 'A1'); const bigQuerySpec = specBuilder.build();
المعلمات
الاسم | النوع | الوصف |
---|---|---|
parameterName | String | اسم المَعلمة |
sourceCell | String | الخلية المصدر، كما هو محدّد في أسلوب A1 |
الإرجاع
BigQueryDataSourceSpecBuilder
— أداة الإنشاء لتسلسل العناصر.
setProjectId(projectId)
لضبط رقم تعريف مشروع الفوترة في BigQuery
المعلمات
الاسم | النوع | الوصف |
---|---|---|
projectId | String | معرّف مشروع الفوترة |
الإرجاع
BigQueryDataSourceSpecBuilder
— أداة الإنشاء لتسلسل العناصر
setRawQuery(rawQuery)
تُستخدَم لضبط سلسلة طلب البحث الأوّلية.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
rawQuery | String | سلسلة طلب البحث الأوّلية. |
الإرجاع
BigQueryDataSourceSpecBuilder
— أداة الإنشاء لتسلسل العناصر.
setTableId(tableId)
تُستخدَم لضبط معرّف جدول BigQuery.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
tableId | String | رقم تعريف الجدول. |
الإرجاع
BigQueryDataSourceSpecBuilder
: هذا المُنشئ، لتسلسل العناصر.
setTableProjectId(projectId)
تُستخدَم لضبط رقم تعريف مشروع BigQuery للجدول.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
projectId | String | رقم تعريف مشروع جدول BigQuery. |
الإرجاع
BigQueryDataSourceSpecBuilder
— أداة الإنشاء لتسلسل العناصر.