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