עדכון קטלוג

עדכון קטלוג (למשל קטלוג Apache Iceberg REST) מאפשר לשנות את המאפיינים שלו, כמו מצב האישורים, מיקום ברירת המחדל של מחסן הנתונים או סוג הקטלוג הבסיסי. לדוגמה, אפשר לשדרג קטלוג של קטגוריית Cloud Storage מדור קודם (gs:// catalog) לקטלוג BigLake (bl:// catalog).

לפני שמתחילים

  1. מוודאים שהחיוב מופעל בפרויקט Google Cloud .

  2. מפעילים את BigLake API.

    תפקידים שנדרשים להפעלת ממשקי API

    כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

    להפעלת ה-API

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות בשביל לעדכן קטלוג, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM:

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

עדכון קטלוג

אתם יכולים לעדכן את ההגדרה של קטלוג, למשל לשנות את התיאור, את מצב האישורים או את המיקומים המותרים.

בנוסף, אפשר לשדרג קטלוג קיים של קטגוריות ב-Cloud Storage (קטלוג מדור קודם של gs://) לקטלוג BigLake (קטלוג של bl://). הקטלוג המשודרג שומר על השם המקורי של הקטגוריה. אחרי השדרוג, אפשר לשייך כמה קטגוריות ולהגדיר מיקומים מוגבלים.

אפשר לעדכן קטלוג באמצעותGoogle Cloud המסוףgcloud או ה-API בארכיטקטורת REST.

המסוף

  1. במסוף Google Cloud , פותחים את הדף Lakehouse.

    מעבר אל Lakehouse

  2. בשורה של הקטלוג שרוצים לעדכן, לוחצים על סמל האפשרויות הנוספות של הקטלוג > עריכה.

  3. בקטע הגדרות הקטלוג, משנים את ההגדרות שרוצים לעדכן.

  4. לוחצים על שמירה.

gcloud

משתמשים בפקודה gcloud beta biglake iceberg catalogs update.

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    [--description="DESCRIPTION"] \
    [--credential-mode="CREDENTIAL_MODE"] \
    [--restricted-locations="RESTRICTED_LOCATIONS"] \
    [--catalog-type=biglake]

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CATALOG_ID: המזהה של קטלוג זמן הריצה של Lakehouse.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫DESCRIPTION: (אופציונלי) תיאור לקטלוג.
  • ‫CREDENTIAL_MODE: (אופציונלי) שיטת האימות. משתמשים ב-end-user בשביל פרטי כניסה של משתמשי קצה או ב-vended-credentials בשביל מצב מכירת פרטי כניסה.
  • ‫RESTRICTED_LOCATIONS: (אופציונלי) רשימה מופרדת בפסיקים של נתיבים או קטגוריות אחסון נוספים שמותרים.

REST

כדי לשנות קטלוג או לשדרג את הסוג שלו באמצעות API בארכיטקטורת REST, שולחים בקשת PATCH לנקודת הקצה UpdateIcebergCatalog עם הערך המתאים של updateMask:

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=icebergCatalog.catalogType,icebergCatalog.description

גוף הבקשה צריך להכיל מטען ייעודי (payload) בפורמט JSON עם השדות שרוצים לעדכן:IcebergCatalog

{
  "catalogType": "BIGLAKE",
  "description": "Updated catalog description"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫CATALOG_ID: המזהה של קטלוג זמן הריצה של Lakehouse.