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