این صفحه به‌وسیله ‏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 - نوع منبع داده.