רישום של טבלת Apache Iceberg קיימת משלב את המטא-נתונים שלה בקטלוג של זמן הריצה של Lakehouse, וכך הופך את נתוני הטבלה לזמינים לשאילתות ולניהול במרחב שמות. התהליך הזה שונה מיצירת טבלה, שבה מתבצעת אתחול של מבנה טבלה חדש וריק ושל האחסון שמשויך אליו.
לפני שמתחילים
-
מפעילים את BigLake API.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, נדרשת ההרשאה
serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק 'שימוש בשירות'' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים - מגדירים את קטלוג זמן הריצה של Lakehouse עם נקודת הקצה (endpoint) של קטלוג REST של Apache Iceberg.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לרישום טבלה, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט ובקטגוריית האחסון:
-
רישום טבלה:
- אדמין BigLake (
roles/biglake.admin) – הפרויקט שלכם - אדמין לניהול נפח האחסון (
roles/storage.admin) – קטגוריה של Cloud Storage
- אדמין BigLake (
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
רישום טבלה
רישום של טבלת Iceberg קיימת.
gcloud
כדי לרשום טבלה באמצעות gcloud, מריצים את הפקודה gcloud biglake iceberg tables register.