תוסף Google BigQuery

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

גרסה 2.0.2

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

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

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

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

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

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

  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>

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

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