Class BigQueryDataSourceSpecBuilder

أداةإنشاءمواصفاتمصادرالبياناتفي BigQuery

منشئ BigQueryDataSourceSpecBuilder.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
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 — أداة الإنشاء لتسلسل العناصر