תוסף Google BigQuery

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

גרסה 1.2.1

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

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

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

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

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

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

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

תשובה

ללא.

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"}
  ]
}
פרמטר התיאור תיאור ברירת המחדל נדרש
שורות מערך של שורות שהוחזר מהבקשה. Array ללא. כן.

סימוכין לתצורה

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

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

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

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

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

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

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