תוסף Google BigQuery

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info

גרסה 2.0.0

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

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

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

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

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

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

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

מידע על Google BigQuery

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

למבוא מעשי, כדאי לנסות את אחד ממדריכי המתחילים של 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>

פרמטרים של בקשות

פרמטר תיאור סוג ברירת מחדל חובה
dataset המזהה של מערך הנתונים שרוצים להוסיף ל-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>

פרמטרים של בקשות

פרמטר תיאור סוג ברירת מחדל חובה
dataset המזהה של מערך הנתונים שממנו רוצים להציג את השורות. מחרוזת ללא. כן.
הגבלה המספר המקסימלי של שורות ברשימה. מספר שלם ללא. לא.
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, זהו התוכן של קובץ המפתח של חשבון השירות. כששולחים אותו דרך ממשק ה-API לניהול, הוא ערך בקידוד base64 שנוצר מקובץ המפתח של חשבון השירות. ללא. כן.