Class DataSourceSpec

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

Methods

שיטהסוג הערך שמוחזרתיאור קצר
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',
);
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 — סוג מקור הנתונים.