Class DataSourceSpec

DataSourceSpec

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

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

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

var dataSourceTable =
    SpreadsheetApp.getActive().getSheetByName("Data Sheet 1").getDataSourceTables()[0];
var spec = dataSourceTable.getDataSource().getSpec();
if (spec.getType() == SpreadsheetApp.DataSourceType.BIGQUERY) {
  var 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');
var spec = ss.getDataSources()[0].getSpec().asLooker();

if (spec.getType() == SpreadsheetApp.DataSourceType.LOOKER) {
  var 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');
var 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');
var spec = ss.getDataSources()[0].getSpec();

var 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');
var spec = ss.getDataSources()[0].getSpec();
var 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');
var spec = ss.getDataSources()[0].getSpec();
var type = spec.getType();

الإرجاع

DataSourceType — نوع مصدر البيانات