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

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 – ה-builder.

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 – סוג מקור הנתונים.