יצירת מרחב שמות

יצירת מרחב שמות בקטלוג (כמו קטלוג REST של Apache Iceberg או קטלוג Apache Hive) עוזרת לארגן את הטבלאות בתוך קטלוג זמן הריצה של Lakehouse.

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

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

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

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

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

    להפעלת ה-API

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

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

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

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

יצירת מרחב שמות

יצירת מרחב שמות בקטלוג.

לתשומת ליבכם

כשיוצרים מרחב שמות, אפשר לציין קטגוריה של Cloud Storage או נתיב לקטגוריה כדי לשייך אותם למרחב השמות:

  • קטלוגים של BigLake: אפשר להגדיר כל מיקום מותאם אישית, כל עוד הוא נמצא במיקום שמותר על ידי הקטלוג (default_location או restricted_locations). אם לא מציינים מיקום, מרחב השמות נוצר במיקום ברירת המחדל של הקטלוג (לדוגמה, gs://{default_location}/{namespace_name}).

  • קטלוגים של קטגוריות Cloud Storage: המיקום תואם לקטגוריית מחסן הנתונים.

המסוף

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

    מעבר אל Lakehouse

  2. בוחרים קטלוג קיים או יוצרים קטלוג חדש אם אין לכם קטלוג.

  3. בסרגל התפריטים, לוחצים על + יצירת מרחב שמות.

  4. בשדה Namespace name (שם מרחב השמות), מזינים שם ייחודי למרחב השמות.

  5. באפשרות מיקום, אפשר לציין קטגוריה של Cloud Storage או נתיב לשיוך למרחב השמות. המיקום תואם לקטגוריית המחסן.

  6. לוחצים על יצירה.

    מרחב השמות נוצר ומופיע ברשימת הפרטים של הקטלוג.

gcloud

כדי ליצור מרחב שמות באמצעות gcloud, מריצים את הפקודה gcloud biglake iceberg namespaces create.

gcloud biglake iceberg namespaces create NAMESPACE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID"

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

  • ‫NAMESPACE_NAME: שם למרחב השמות.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫CATALOG_ID: המזהה של הקטלוג.

REST

כדי ליצור מרחב שמות באמצעות API בארכיטקטורת REST, שולחים בקשת POST לנקודת הקצה CreateIcebergNamespace:

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces

גוף הבקשה חייב להכיל מטען ייעודי (payload) תקין של Iceberg CreateNamespaceRequest בפורמט JSON, שמגדיר את מזהה מרחב השמות והמאפיינים.

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

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