הפעלת הקצאה של פרטי כניסה

הקטלוג הייעודי לזמן ריצה של Lakehouse מאפשר להפעיל מצב של הפצת פרטי כניסה לנקודות קצה של קטלוג ב-Lakehouse ללא גבולות.

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

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

  1. במאמר מידע על הקטלוג הייעודי לזמן ריצה של Lakehouse מוסבר איך הקטלוג פועל ומהן המגבלות של השירות.
  2. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

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

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

  • הכול:
  • חשבון שירות של קטלוג REST של Apache Iceberg שהוקצה אוטומטית: משתמש באובייקטים של אחסון (roles/storage.objectUser) בכל הקטגוריות המשויכות של Cloud Storage. אחרי שמפעילים את הנפקת פרטי הכניסה, מקצים באופן מפורש את התפקיד "משתמש באובייקטים של אחסון" (roles/storage.objectUser) בכל קטגוריות האחסון שמשויכות לחשבון השירות של קטלוג REST של Apache Iceberg שהוקצה אוטומטית לקטלוג.

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

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

אם הקטגוריות של Cloud Storage שמשויכות לנקודת הקצה של הקטלוג מוגנות על ידי גבולות גזרה לשירות של VPC Service Controls, צריך להגדיר גם כלל תעבורת נתונים נכנסת (ingress) לחשבון השירות של הקטלוג. מידע נוסף זמין במאמר שימוש ב-VPC Service Controls עם שירות להנפקת פרטי כניסה.

הפעלת הפצת פרטי כניסה

אם שיטת האימות של נקודת הקצה של קטלוג Apache Iceberg REST מוגדרת לפרטי כניסה של משתמש קצה, אתם יכולים להעביר אותה למצב הפצת פרטי כניסה.

המסוף

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

מעבר אל Lakehouse

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

  2. בתיבת הדו-שיח של האימות, בוחרים באפשרות Credential vending mode. חשבון השירות של קטלוג REST של Apache Iceberg שנוצר בהקצאת משאבים אוטומטית דורש את התפקיד המפורש Storage Object User (roles/storage.objectUser) בכל הקטגוריות המשויכות של Cloud Storage. כברירת מחדל, אין לו גישה. בלי התפקיד הזה, לפרטי הכניסה שהונפקו אין היקף הרשאות מספיק כדי לבצע כתיבה באחסון.

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

      Your catalog is updated and the **Catalog details** page opens.
    
  4. בקטע שיטת אימות, בוחרים באפשרות הגדרת הרשאות לקטגוריה.

  5. בתיבת הדו-שיח, לוחצים על אישור.

כך מוודאים שלחשבון השירות של הקטלוג יש את התפקיד "משתמש באובייקט אחסון" (roles/storage.objectUser) בכל קטגוריות האחסון המשויכות.

gcloud

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

gcloud biglake iceberg catalogs update \
    CATALOG_NAME \
    --project PROJECT_ID \
    --credential-mode vended-credentials

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

  • ‫CATALOG_NAME: שם לקטלוג. בקטלוגים של Lakehouse, זה השם של הקטלוג בהתאמה אישית. בקטלוגים של קטגוריות ב-Cloud Storage, המזהה הזה תואם למזהה הקטגוריה ב-Cloud Storage שמשמשת את קטלוג ה-REST. השם הזה משמש גם כמזהה הקטלוג כששולחים שאילתות לטבלאות האלה מ-BigQuery.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud.

    אחרי שמפעילים את הקצאת פרטי הכניסה, מקצים באופן מפורש את התפקיד משתמש באובייקטים של אחסון (roles/storage.objectUser) בכל קטגוריות האחסון שמשויכות לחשבון השירות של קטלוג REST של Apache Iceberg, שהוקצה באופן אוטומטי לקטלוג.

REST

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

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=credential_mode

גוף הבקשה חייב להכיל מטען ייעודי (payload) של IcebergCatalog בפורמט JSON, עם credential_mode שמוגדר ל-VENDED_CREDENTIALS.

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

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