Class DataSourceSpec

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