این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class DataSourceSpec

دسترسی به تنظیمات کلی یک منبع داده موجود. برای دسترسی به مشخصات منبع داده برای نوع خاصی، از روش as...() استفاده کنید. برای ایجاد مشخصات منبع داده جدید، از Spreadsheet App.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 را نشان می دهد. استفاده از as Looker() یک شیء Looker Data Source Spec برمی گرداند.

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

روش ها

روش	نوع برگشت	شرح مختصر
`as Big Query()`	`Big Query Data Source Spec`	مشخصات منبع داده BigQuery را دریافت می کند.
`as Looker()`	`Looker Data Source Spec`	مشخصات منبع داده Looker را دریافت می کند.
`copy()`	`Data Source Spec Builder`	بر اساس تنظیمات این منبع داده، یک `Data Source Spec Builder` ایجاد می کند.
`get Parameters()`	`Data Source Parameter[]`	پارامترهای منبع داده را دریافت می کند.
`get Type()`	`Data Source Type`	نوع منبع داده را دریافت می کند.

مستندات دقیق

`as Big Query()`

مشخصات منبع داده BigQuery را دریافت می کند.

بازگشت

Big Query Data Source Spec - مشخصات منبع داده BigQuery.

`as Looker()`

مشخصات منبع داده 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();

بازگشت

Looker Data Source Spec - مشخصات منبع داده Looker.

`copy()`

بر اساس تنظیمات این منبع داده، یک Data Source Spec Builder ایجاد می کند.

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

بازگشت

Data Source Spec Builder - سازنده.

`get Parameters()`

پارامترهای منبع داده را دریافت می کند.

// 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 در دسترس است.

بازگشت

Data Source Parameter[] - فهرست پارامترها.

`get Type()`

نوع منبع داده را دریافت می کند.

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

بازگشت

Data Source Type - نوع منبع داده.