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