אם יש לכם טבלאות Apache Iceberg קיימות בגרסה 1 (V1), אתם צריכים לשדרג אותן באמצעות מנוע השאילתות לפני שאתם משתמשים בהן עם נקודת הקצה של קטלוג Apache Iceberg REST. מידע נוסף זמין במאמר שינוי טבלה.
לפני שמתחילים
-
מפעילים את BigLake API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). כך מקצים תפקידים. - מגדירים את הקטלוג הייעודי לזמן ריצה של Lakehouse עם נקודת הקצה (endpoint) של קטלוג REST של Apache Iceberg.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות לשדרוג טבלה, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט ובקטגוריית האחסון:
-
שדרוג טבלה במצב הפצת פרטי כניסה:
עריכת BigLake (
roles/biglake.editor) – הפרויקט -
שדרוג הטבלה במצב שאינו מצב הפצת פרטי כניסה:
- עריכת BigLake (
roles/biglake.editor) – הפרויקט - משתמש באובייקטים באחסון (
roles/storage.objectUser) – הקטגוריה של Cloud Storage
- עריכת BigLake (
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
שדרוג טבלה
כדי לשדרג טבלה מגרסה 1 של Iceberg לגרסה 2, מריצים את הפקודה הבאה במנוע השאילתות:
Spark
ALTER TABLE CATALOG_NAME.SCHEMA_NAME.TABLE_NAME SET TBLPROPERTIES ('format-version'='2');
מחליפים את מה שכתוב בשדות הבאים:
-
CATALOG_NAME: שם הקטלוג. -
SCHEMA_NAME: שם הסכימה. -
TABLE_NAME: שם הטבלה.