Class DataSourceSpec

مواصفاتمصدر البيانات

يمكنك الوصول إلى الإعدادات العامة لمواصفات مصدر بيانات حالي. للوصول إلى مواصفات مصدر البيانات لنوع معيّن، استخدِم طريقة as...(). لإنشاء مواصفات مصدر بيانات جديدة، استخدِم SpreadsheetApp.newDataSourceSpec().

لا تستخدِم هذه الفئة إلا مع البيانات المرتبطة بقاعدة بيانات.

يوضّح هذا المثال كيفية الحصول على معلومات من مواصفات مصدر بيانات BigQuery. 

const dataSourceTable = SpreadsheetApp.getActive()
                            .getSheetByName('Data Sheet 1')
                            .getDataSourceTables()[0];
const spec = dataSourceTable.getDataSource().getSpec();
if (spec.getType() === SpreadsheetApp.DataSourceType.BIGQUERY) {
  const bqSpec = spec.asBigQuery();
  Logger.log('Project ID: %s\n', bqSpec.getProjectId());
  Logger.log('Raw query string: %s\n', bqSpec.getRawQuery());
}

يوضّح هذا المثال كيفية الحصول على معلومات من مواصفات مصدر بيانات Looker. يؤدي استخدام asLooker() إلى عرض عنصر LookerDataSourceSpec. 

// 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().asLooker();

if (spec.getType() === SpreadsheetApp.DataSourceType.LOOKER) {
  const lookerSpec = spec.asLooker();
  Logger.log('Looker instance URL: %s\n', lookerSpec.getInstanceUrl());
}

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
asBigQuery()BigQueryDataSourceSpecتحصل على مواصفات مصدر بيانات BigQuery.
asLooker()LookerDataSourceSpecتحصل على مواصفات مصدر بيانات Looker.
copy()DataSourceSpecBuilderتُنشئ DataSourceSpecBuilder استنادًا إلى إعدادات مصدر البيانات هذا.
getParameters()DataSourceParameter[]تحصل على مَعلمات مصدر البيانات.
getType()DataSourceTypeتحصل على نوع مصدر البيانات.

مستندات تفصيلية

asBigQuery()

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

الإرجاع

‫BigQueryDataSourceSpec: مواصفات مصدر بيانات BigQuery

asLooker()

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

// 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().asLooker();

الإرجاع

‫LookerDataSourceSpec: مواصفات مصدر بيانات Looker

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: صانع المحتوى

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[] - قائمة المَعلمات

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: نوع مصدر البيانات