תוסף Google BigQuery

אתם קוראים את מאמרי העזרה של Apigee Edge.
כדאי לעיין במסמכי העזרה בנושא Apigee X. מידע

גרסה 2.0.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.

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

המאפיינים הבאים קיימים בכל תוסף.

נכס תיאור ברירת המחדל נדרש
name השם שבחרת לתצורה הזו של התוסף. ללא כן
packageName השם של חבילת התוסף כפי שהוא סופק על ידי Apigee Edge. ללא כן
version מספר הגרסה של חבילת התוסף שממנה מגדירים את התוסף. ללא כן
configuration ערך הגדרה ספציפי לתוסף שרוצים להוסיף. מאפיינים לחבילת תוספים זו ללא כן

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

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

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