תוסף Google BigQuery

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X.
מידע

גרסה 1.2.1

הוספת שורות לטבלה ב-BigQuery. מציגים את השורות מהטבלה.

דרישות מוקדמות

התוכן הזה מספק הפניה להגדרת התוסף הזה ולשימוש בו. לפני שמשתמשים בתוסף משרת proxy ל-API באמצעות מדיניות ExtensionCallout, צריך:

  1. מוודאים שהפעלתם את BigQuery API בחשבון.

  2. לפני שמנסים להוסיף שורות, צריך לוודא שיצרתם מערך נתונים וטבלה ב-BigQuery (עם סכימה).

  3. שימוש במסוף GCP כדי ליצור מפתח לחשבון השירות.

  4. משתמשים בתוכן של קובץ ה-JSON של המפתח שנוצר כשמוסיפים ומגדירים את התוסף באמצעות הפניה להגדרות.

מידע על Google BigQuery

‫Google BigQuery הוא מחסן נתונים (data warehouse) ארגוני שניתן להתאמה, במודל ללא שרת, שמאפשר להריץ שאילתות SQL מהירות במיוחד באמצעות כוח העיבוד של התשתית של Google. מכיוון שאין תשתית שצריך לנהל, תוכלו להתמקד בניתוח נתונים כדי לחשוף תובנות משמעותיות באמצעות שפת SQL מוכרת, ללא צורך בניהול של מסד נתונים.

כדי להתנסות בעבודה עם BigQuery, אפשר לנסות את אחד ממדריכי ההתחלה המהירה של Google BigQuery.

פעולות

insert

הוספת קבוצה של רשומות כמערך נתונים ישירות ל-BigQuery, עם שורות להוספה ומזהה של מערך נתונים או טבלה.

תחביר

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : dataset-to-insert,
  "table" : table-to-receive-data,
  "rows" : array-of-rows-to-insert
}]]></Input>

דוגמה

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "table" : "TestTable",
  "rows" : [
    {"technology":"CRISPR","inventorFirstName":"Jennifer","inventorLastName":"Doudna"},
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}]]></Input>

פרמטרים של בקשה

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

תשובה

ללא.

listRows

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

תחביר

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : ID-of-dataset-to-examine,
  "limit" : maximum-rows-to-list,
  "startIndex" : row-index-at-which-to-start-list
  "table" : ID-of-table-to-examine
}]]></Input>

דוגמה

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "limit" : 2,
  "startIndex" : 1,
  "table" : "TestTable"
}]]></Input>

פרמטרים של בקשה

פרמטר תיאור סוג ברירת מחדל חובה
קבוצת נתונים המזהה של קבוצת הנתונים שממנה רוצים להציג את השורות. מחרוזת ללא. כן.
הגבלה המספר המקסימלי של שורות שיוצגו ברשימה. מספר שלם ללא. לא.
startIndex אינדקס השורה שבה מתחילה הרשימה. מספר שלם ללא. לא.
שולחן המזהה של הטבלה שממנה רוצים להציג את השורות. מחרוזת ללא. כן.

תשובה

מערך rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
פרמטר תיאור סוג ברירת מחדל חובה
שורות מערך של שורות שמוחזרות מהבקשה. מערך ללא. כן.

הסבר על ההגדרות

כשמגדירים ופורסים את התוסף הזה לשימוש בשרתי proxy ל-API, צריך להשתמש בהגדרות הבאות. במאמר הוספה והגדרה של תוסף מוסבר איך להגדיר תוסף באמצעות מסוף Apigee.

מאפיינים נפוצים של תוספים

The following properties are present for every extension.

Property Description Default Required
name Name you're giving this configuration of the extension. None Yes
packageName Name of the extension package as given by Apigee Edge. None Yes
version Version number for the extension package from which you're configuring an extension. None Yes
configuration Configuration value specific to the extension you're adding. See Properties for this extension package None Yes

מאפיינים של חבילת התוסף הזו

מציינים ערכים למאפייני ההגדרה הבאים שספציפיים לתוסף הזה.

נכס תיאור ברירת מחדל חובה
projectId מזהה הפרויקט ב-GCP שבו נמצאים הנתונים. ללא. כן.
פרטי כניסה כשמזינים את התוכן הזה במסוף Apigee Edge, זהו התוכן של קובץ המפתח של חשבון השירות. כששולחים את הערך הזה דרך Management API, הוא מקודד ב-Base64 ונוצר מקובץ המפתח של חשבון השירות. ללא. כן.