Class LookerDataSourceSpecBuilder

LookerDataSourceSpecBuilder

سازنده‌ی LookerDataSourceSpecBuilder .

این مثال نحوه ایجاد یک سازنده جدید Looker Data Source Spec را نشان می‌دهد.

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();

روش‌ها

روش نوع بازگشتی شرح مختصر
build() Data Source Spec مشخصات منبع داده را از تنظیمات موجود در این سازنده می‌سازد.
copy() Data Source Spec Builder بر اساس تنظیمات این منبع داده، یک Data Source Spec Builder ایجاد می‌کند.
get Explore Name() String نام جستجوگر (Looker) را در مدل دریافت می‌کند.
get Instance Url() String آدرس URL نمونه Looker را دریافت می‌کند.
get Model Name() String نام مدل Looker را در نمونه دریافت می‌کند.
get Parameters() Data Source Parameter[] پارامترهای منبع داده را دریافت می‌کند.
get Type() Data Source Type نوع منبع داده را دریافت می‌کند.
remove All Parameters() Looker Data Source Spec Builder تمام پارامترها را حذف می‌کند.
remove Parameter(parameterName) Looker Data Source Spec Builder پارامتر مشخص شده را حذف می‌کند.
set Explore Name(exploreName) Looker Data Source Spec Builder نام کاوش را در مدل Looker تنظیم می‌کند.
set Instance Url(instanceUrl) Looker Data Source Spec Builder آدرس اینترنتی (URL) نمونه را برای Looker تنظیم می‌کند.
set Model Name(modelName) Looker Data Source Spec Builder نام مدل Looker را در نمونه Looker تنظیم می‌کند.
set Parameter From Cell(parameterName, sourceCell) Looker Data Source Spec Builder یک پارامتر اضافه می‌کند، یا اگر پارامتری با نام وجود داشته باشد، سلول منبع آن را برای سازندگان مشخصات منبع داده از نوع Data Source Type.BIGQUERY به‌روزرسانی می‌کند.

مستندات دقیق

build()

مشخصات منبع داده را از تنظیمات موجود در این سازنده می‌سازد. قبل از ساخت، باید as...() برای مشخص کردن نوع منبع داده استفاده کنید.

نمونه کد زیر یک BigQuery DataSource Spec می‌سازد.

const bigQueryDataSourceSpec = SpreadsheetApp.newDataSourceSpec().asBigQuery();
// TODO(developer): Replace with the required dataset, project and table IDs.
bigQueryDataSourceSpec.setDatasetId('my data set id');
bigQueryDataSourceSpec.setProjectId('my project id');
bigQueryDataSourceSpec.setTableId('my table id');

bigQueryDataSourceSpec.build();

نمونه کد زیر یک Looker DataSource Spec می‌سازد.

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();
const lookerSpec = lookerDataSourceSpecBuilder.setExploreName('my explore name')
                       .setInstanceUrl('my instance url')
                       .setModelName('my model name')
                       .build();

بازگشت

DataSourceSpec — مشخصات منبع داده.

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 — سازنده.

getExploreName()

نام جستجوگر (Looker) را در مدل دریافت می‌کند.

// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

const lookerDataSourceSpec = ss.getDataSources()[0].getSpec().asLooker();
const exploreName = lookerDataSourceSpec.getExploreName();
Logger.log(exploreName);

بازگشت

String - نام جستجوگر.

getInstanceUrl()

آدرس URL نمونه Looker را دریافت می‌کند.

// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

const lookerDataSourceSpec = ss.getDataSources()[0].getSpec().asLooker();
const instanceUrl = lookerDataSourceSpec.getInstanceUrl();
Logger.log(instanceUrl);

بازگشت

String - آدرس اینترنتی (URL) نمونه Looker.

getModelName()

نام مدل Looker را در نمونه دریافت می‌کند.

// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

const lookerDataSourceSpec = ss.getDataSources()[0].getSpec().asLooker();
const modelName = lookerDataSourceSpec.getModelName();
Logger.log(modelName);

بازگشت

String - نام مدل Looker.

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

removeAllParameters()

تمام پارامترها را حذف می‌کند. 

const specBuilder = SpreadsheetApp.newDataSourceSpec();
specBuilder.removeAllParameters();

بازگشت

LookerDataSourceSpecBuilder — سازنده، برای زنجیره‌سازی.

removeParameter(parameterName)

پارامتر مشخص شده را حذف می‌کند. 

const specBuilder = SpreadsheetApp.newDataSourceSpec();
specBuilder.removeParameter('x');

پارامترها

نام نوع توضیحات
parameter Name String نام پارامتری که باید حذف شود.

بازگشت

LookerDataSourceSpecBuilder — سازنده، برای زنجیره‌سازی.

setExploreName(exploreName)

نام کاوش را در مدل Looker تنظیم می‌کند. 

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();
// TODO(developer): replace explore name with your own
lookerDataSourceSpecBuilder.setExploreName('my explore name');

پارامترها

نام نوع توضیحات
explore Name String نام کاوش در مدل Looker انتخاب شده.

بازگشت

LookerDataSourceSpecBuilder — این سازنده، برای زنجیره‌سازی.

setInstanceUrl(instanceUrl)

آدرس اینترنتی (URL) نمونه را برای Looker تنظیم می‌کند. 

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();
// TODO(developer): replace instance url with your own
lookerDataSourceSpecBuilder.setInstanceUrl('my instance url');

پارامترها

نام نوع توضیحات
instance Url String آدرس اینترنتی (URL) نمونه‌ی Looker.

بازگشت

LookerDataSourceSpecBuilder — سازنده، برای زنجیره‌سازی.

setModelName(modelName)

نام مدل Looker را در نمونه Looker تنظیم می‌کند. 

const lookerDataSourceSpecBuilder =
    SpreadsheetApp.newDataSourceSpec().asLooker();
// TODO(developer): replace model name with your own
lookerDataSourceSpecBuilder.setModelName('my model name');

پارامترها

نام نوع توضیحات
model Name String نام مدل در نمونه Looker.

بازگشت

LookerDataSourceSpecBuilder — سازنده، برای زنجیره‌سازی.

setParameterFromCell(parameterName, sourceCell)

یک پارامتر اضافه می‌کند، یا اگر پارامتری با نام وجود داشته باشد، سلول منبع آن را برای سازندگان مشخصات منبع داده از نوع DataSourceType.BIGQUERY به‌روزرسانی می‌کند.

این روش فقط برای منابع داده BigQuery در دسترس است. 

const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery();
specBuilder.setParameterFromCell('x', 'A1');
const bigQuerySpec = specBuilder.build();

پارامترها

نام نوع توضیحات
parameter Name String نام پارامتر.
source Cell String سلول منبع، همانطور که در نمادگذاری A1 مشخص شده است.

بازگشت

LookerDataSourceSpecBuilder — سازنده، برای زنجیره‌سازی.