דף זה תורגם על ידי Cloud Translation API.

Class DataSourceSpec

גישה להגדרות הכלליות של מפרט קיים של מקור נתונים. כדי לגשת למפרט של מקור הנתונים עבור סוג מסוים, יש להשתמש ב-method as...(). כדי ליצור מפרט חדש של מקור נתונים, יש להשתמש ב-SpreadsheetApp.newDataSourceSpec().

יש להשתמש בכיתה הזו רק עם נתונים שמקושרים למסד נתונים.

בדוגמה הזו תוכלו לראות איך לקבל מידע ממפרט מקורות הנתונים של BigQuery.

var dataSourceTable =
    SpreadsheetApp.getActive().getSheetByName("Data Sheet 1").getDataSourceTables()[0];
var spec = dataSourceTable.getDataSource().getSpec();
if (spec.getType() == SpreadsheetApp.DataSourceType.BIGQUERY) {
  var 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');
var spec = ss.getDataSources()[0].getSpec().asLooker();

if (spec.getType() == SpreadsheetApp.DataSourceType.LOOKER) {
  var lookerSpec = spec.asLooker();
  Logger.log("Looker instance URL: %s\n", lookerSpec.getInstanceUrl());
}

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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');
var 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');
var spec = ss.getDataSources()[0].getSpec();

var 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');
var spec = ss.getDataSources()[0].getSpec();
var 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');
var spec = ss.getDataSources()[0].getSpec();
var type = spec.getType();

חזרה

DataSourceType – סוג מקור הנתונים.