מציג את מרחבי השמות של Iceberg בקטלוג. אנחנו תומכים רק ברמה אחת של סידור פנימי למרחבי שמות.
בקשת HTTP
GET https://biglake.googleapis.com/iceberg/v1/restcatalog/v1/{apiParent=projects/*/catalogs/*}/namespaces כתובות ה-URL כתובות בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
apiParent |
חובה. ההורה מנתיב המשאב. |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
pageToken |
זה שינוי אופציונלי. מציינים את pageToken שהוחזר בתשובה הקודמת כדי לאחזר את דף התוצאות הבא. |
pageSize |
זה שינוי אופציונלי. בשרתים שתומכים בחלוקה לדפים, האות הזה מציין את הגבול העליון של מספר התוצאות שהלקוח יקבל. בשרתים שלא תומכים בחלוקה לעמודים, יכול להיות שהלקוחות יקבלו תוצאות גדולות יותר מהערך שצוין ב- |
parent |
זה שינוי אופציונלי. מרחב שמות אופציונלי, שמתחתיו יוצגו מרחבי שמות. אם לא מציינים ערך או מציינים ערך ריק, צריך לציין את כל מרחבי השמות ברמה העליונה. אם מרחב השמות של ההורה הוא מרחב שמות מרובה חלקים, צריך להפריד בין החלקים באמצעות בייט של מפריד יחידות ( |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
הודעת התגובה ל-API namespaces.list.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{ "namespaces": [ array ], "next-page-token": string, "unreachable": [ string ] } |
| שדות | |
|---|---|
namespaces[] |
רשימת מרחבי השמות. |
next-page-token |
הטוקן של הדף הבא להחלפה בין דפים. |
unreachable[] |
פלט בלבד. רשימה של מיקומים שדילגו עליהם כי לא הייתה אפשרות להגיע אליהם. אם הוא לא ריק, יכול להיות שקבוצת התוצאות לא מלאה. |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/bigqueryhttps://www.googleapis.com/auth/cloud-platform
ניתן למצוא מידע נוסף כאן: Authentication Overview.