Class DataSourceSpecBuilder

VeriKaynağıSpesifikasyonuOluşturucu

DataSourceSpec için oluşturucu. Belirli bir tür için spesifikasyon oluşturmak üzere as...() yöntemini kullanın. Yeni bir oluşturucu oluşturmak için SpreadsheetApp.newDataSourceSpec() simgesini kullanın. Spesifikasyonu kullanmak için DataSourceTable başlıklı makaleyi inceleyin.

Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.

Bu örnekte, BigQuery veri kaynağı spesifikasyonunun nasıl oluşturulacağı gösterilmektedir.

const spec = SpreadsheetApp.newDataSourceSpec()
                 .asBigQuery()
                 .setProjectId('big_query_project')
                 .setRawQuery('select @FIELD from table limit @LIMIT')
                 .setParameterFromCell('FIELD', 'Sheet1!A1')
                 .setParameterFromCell('LIMIT', 'namedRangeCell')
                 .build();

Bu örnekte, Looker veri kaynağı spesifikasyonunun nasıl oluşturulacağı gösterilmektedir. build() kullanıldıktan sonra bir LookerDataSourceSpec nesnesi döndürür.

const spec = SpreadsheetApp.newDataSourceSpec()
                 .asLooker()
                 .setInstanceUrl('https://looker_instance_url.com')
                 .setModelName('model_name')
                 .setExploreName('explore_name')
                 .build();

Yöntemler

YöntemDönüş türüKısa açıklama
asBigQuery()BigQueryDataSourceSpecBuilderBigQuery veri kaynağının oluşturucusunu alır.
asLooker()LookerDataSourceSpecBuilderLooker veri kaynağının oluşturucusunu alır.
build()DataSourceSpecBu oluşturucudaki ayarlardan bir veri kaynağı spesifikasyonu oluşturur.
copy()DataSourceSpecBuilderBu veri kaynağının ayarlarına göre bir DataSourceSpecBuilder oluşturur.
getParameters()DataSourceParameter[]Veri kaynağının parametrelerini alır.
getType()DataSourceTypeVeri kaynağının türünü alır.
removeAllParameters()DataSourceSpecBuilderTüm parametreleri kaldırır.
removeParameter(parameterName)DataSourceSpecBuilderBelirtilen parametreyi kaldırır.
setParameterFromCell(parameterName, sourceCell)DataSourceSpecBuilderBir parametre ekler veya adı aynı olan parametre mevcutsa DataSourceType.BIGQUERY türündeki veri kaynağı spesifikasyonu oluşturucular için kaynak hücresini günceller.

Ayrıntılı dokümanlar

asBigQuery()

BigQuery veri kaynağının oluşturucusunu alır.

Return

BigQueryDataSourceSpecBuilder: BigQuery veri kaynağı spesifikasyonu oluşturucu.


asLooker()

Looker veri kaynağının oluşturucusunu alır.

const spec = SpreadsheetApp.newDataSourceSpec()
                 .asLooker()
                 .setInstanceUrl('https://looker_instance_url.com')
                 .setModelName('model_name')
                 .setExploreName('explore_name')
                 .build();

Return

LookerDataSourceSpecBuilder: Looker veri kaynağı spesifikasyon oluşturucusu.


build()

Bu oluşturucudaki ayarlardan bir veri kaynağı spesifikasyonu oluşturur. Oluşturmadan önce veri kaynağı türünü belirtmek için as...() kullanılmalıdır.

Aşağıdaki kod örneği, bir BigQuery veri kaynağı özelliği oluşturur.

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

Aşağıdaki kod örneği, bir Looker DataSource Spec oluşturur.

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

Return

DataSourceSpec: Veri kaynağı spesifikasyonu.


copy()

Bu veri kaynağının ayarlarına göre bir DataSourceSpecBuilder oluşturur.

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

Return

DataSourceSpecBuilder: Oluşturucu.


getParameters()

Veri kaynağının parametrelerini alır.

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

Bu yöntem yalnızca BigQuery veri kaynakları için kullanılabilir.

Return

DataSourceParameter[]: Parametre listesi.


getType()

Veri kaynağının türünü alır.

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

Return

DataSourceType: Veri kaynağı türü.


removeAllParameters()

Tüm parametreleri kaldırır.

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

Return

DataSourceSpecBuilder: Zincirleme için oluşturucu.


removeParameter(parameterName)

Belirtilen parametreyi kaldırır.

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

Parametreler

AdTürAçıklama
parameterNameStringKaldırılacak parametrenin adı.

Return

DataSourceSpecBuilder: Zincirleme için oluşturucu.


setParameterFromCell(parameterName, sourceCell)

Bir parametre ekler veya adı aynı olan parametre mevcutsa DataSourceType.BIGQUERY türündeki veri kaynağı spesifikasyonu oluşturucular için kaynak hücresini günceller.

Bu yöntem yalnızca BigQuery veri kaynakları için kullanılabilir.

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

Parametreler

AdTürAçıklama
parameterNameStringParametre adı.
sourceCellStringA1 gösterimiyle belirtilen kaynak hücre.

Return

DataSourceSpecBuilder: Zincirleme için oluşturucu.