תוסף Google BigQuery

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

גרסה 1.2.1

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

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

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

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

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

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

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

מידע על Google BigQuery

Google BigQuery הוא מחסן נתונים (data warehouse) ארגוני ללא שרת (serverless), שמאפשר לשלוח שאילתות 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 המזהה של הפרויקט ב-GCP שבו הנתונים. ללא. כן.
פרטי כניסה כשמזינים את הקוד במסוף Apigee Edge, זה התוכן של קובץ המפתח של חשבון השירות. כשהוא נשלח דרך ממשק ה-API לניהול, זה ערך בקידוד base64 שנוצר מקובץ המפתח של חשבון השירות. ללא. כן.