ה-builder של Data. כדי ליצור מפרט לסוג מסוים, משתמשים בשיטה as...(). כדי ליצור build חדש, משתמשים ב-Spreadsheet. למידע נוסף על השימוש במפרט, אפשר לעיין במאמר Data.
יש להשתמש בכיתה הזו רק עם נתונים שמקושרים למסד נתונים.
בדוגמה הזו מוסבר איך ליצור מפרט של מקור נתונים ב-BigQuery.
const spec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('big_query_project') .setRawQuery('select @FIELD from table limit @LIMIT') .setParameterFromCell('FIELD', 'Sheet1!A1') .setParameterFromCell('LIMIT', 'namedRangeCell') .build();
בדוגמה הזו מוסבר איך ליצור מפרט של מקור נתונים ב-Looker. הפונקציה מחזירה אובייקט Looker אחרי שימוש ב-build().
const spec = SpreadsheetApp.newDataSourceSpec() .asLooker() .setInstanceUrl('https://looker_instance_url.com') .setModelName('model_name') .setExploreName('explore_name') .build();
Methods
| שיטה | סוג הערך המוחזר | תיאור קצר |
|---|---|---|
as | Big | הפונקציה מקבלת את ה-builder של מקור הנתונים ב-BigQuery. |
as | Looker | הפונקציה מקבלת את ה-builder של מקור הנתונים של Looker. |
build() | Data | יצירת מפרט של מקור נתונים מההגדרות שב-builder הזה. |
copy() | Data | יצירת Data על סמך ההגדרות של מקור הנתונים הזה. |
get | Data | הפונקציה מקבלת את הפרמטרים של מקור הנתונים. |
get | Data | הפונקציה מקבלת את הסוג של מקור הנתונים. |
remove | Data | הסרת כל הפרמטרים. |
remove | Data | הסרת הפרמטר שצוין. |
set | Data | הוספת פרמטר, או אם הפרמטר עם השם הזה קיים, עדכון תא המקור שלו ליצירת מפרטי מקורות נתונים מסוג Data. |
מסמכים מפורטים
as Big Query()
הפונקציה מקבלת את ה-builder של מקור הנתונים ב-BigQuery.
חזרה
Big – הכלי ליצירת מפרטי מקורות הנתונים של BigQuery.
as Looker()
הפונקציה מקבלת את ה-builder של מקור הנתונים של Looker.
const spec = SpreadsheetApp.newDataSourceSpec() .asLooker() .setInstanceUrl('https://looker_instance_url.com') .setModelName('model_name') .setExploreName('explore_name') .build();
חזרה
Looker – הכלי ליצירת מפרטי מקורות הנתונים ב-Looker.
build()
יצירת מפרט של מקור נתונים מההגדרות שב-builder הזה. צריך להשתמש ב-as...()
כדי לציין את סוג מקור הנתונים לפני ה-build.
דוגמת הקוד הבאה יוצרת מפרט של BigQuery DataSource.
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();
דוגמת הקוד הבאה יוצרת מפרט של מקור נתונים ב-Looker.
const lookerDataSourceSpecBuilder = SpreadsheetApp.newDataSourceSpec().asLooker(); const lookerSpec = lookerDataSourceSpecBuilder.setExploreName('my explore name') .setInstanceUrl('my instance url') .setModelName('my model name') .build();
חזרה
Data – המפרט של מקור הנתונים.
copy()
יצירת Data על סמך ההגדרות של מקור הנתונים הזה.
// 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();
חזרה
Data – ה-builder.
get Parameters()
הפונקציה מקבלת את הפרמטרים של מקור הנתונים.
// 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.
חזרה
Data – רשימת הפרמטרים.
get Type()
הפונקציה מקבלת את הסוג של מקור הנתונים.
// 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();
חזרה
Data – סוג מקור הנתונים.
remove All Parameters()
הסרת כל הפרמטרים.
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeAllParameters();
חזרה
Data – ה-builder, לצורך קישור.
remove Parameter(parameterName)
הסרת הפרמטר שצוין.
const specBuilder = SpreadsheetApp.newDataSourceSpec(); specBuilder.removeParameter('x');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
parameter | String | שם הפרמטר שרוצים להסיר. |
חזרה
Data – ה-builder, לצורך קישור.
set Parameter From Cell(parameterName, sourceCell)
הוספת פרמטר, או אם הפרמטר עם השם הזה קיים, עדכון תא המקור שלו ליצירת מפרטי מקורות נתונים מסוג Data.
השיטה הזו זמינה רק למקורות נתונים של BigQuery.
const specBuilder = SpreadsheetApp.newDataSourceSpec().asBigQuery(); specBuilder.setParameterFromCell('x', 'A1'); const bigQuerySpec = specBuilder.build();
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
parameter | String | שם הפרמטר. |
source | String | תא המקור, כפי שצוין בסימון A1. |
חזרה
Data – ה-builder, לצורך קישור.