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

روش‌ها

روش نوع بازگشتی شرح مختصر
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 نوع منبع داده را دریافت می‌کند.

مستندات دقیق

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 — نوع منبع داده.