تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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