הקטלוג הייעודי לזמן ריצה של Lakehouse מאפשר להפעיל מצב של הפצת פרטי כניסה לנקודות קצה של קטלוג ב-Lakehouse ללא גבולות.
מצב הנפקת פרטי כניסה מנפיק אסימוני אחסון לטווח קצר ובהיקף מצומצם למנועי שאילתות ולעומסי עבודה מורשים. בשיטת האימות הזו, אתם או זמני הריצה של השאילתות לא צריכים הרשאות קריאה וכתיבה ישירות בקטגוריה הבסיסית של Cloud Storage.
לפני שמתחילים
- במאמר מידע על הקטלוג הייעודי לזמן ריצה של Lakehouse מוסבר איך הקטלוג פועל ומהן המגבלות של השירות.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles. - 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
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.
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
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.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות להפעלת הנפקת פרטי כניסה, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM:
-
הכול:
- אדמין BigLake (
roles/biglake.admin) בפרויקט - אדמין באחסון (
roles/storage.admin) בפרויקט
- אדמין BigLake (
-
חשבון שירות של קטלוג 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 מוגדרת לפרטי כניסה של משתמש קצה, אתם יכולים להעביר אותה למצב הפצת פרטי כניסה.
המסוף
- פותחים את הדף Lakehouse במסוף Google Cloud .
בשורה של הקטלוג שמעדכנים, לוחצים על פעולות נוספות בקטלוג > עריכת האימות.
בתיבת הדו-שיח של האימות, בוחרים באפשרות Credential vending mode. חשבון השירות של קטלוג REST של Apache Iceberg שנוצר בהקצאת משאבים אוטומטית דורש את התפקיד המפורש Storage Object User (
roles/storage.objectUser) בכל הקטגוריות המשויכות של Cloud Storage. כברירת מחדל, אין לו גישה. בלי התפקיד הזה, לפרטי הכניסה שהונפקו אין היקף הרשאות מספיק כדי לבצע כתיבה באחסון.לוחצים על שמירה.
Your catalog is updated and the **Catalog details** page opens.בקטע שיטת אימות, בוחרים באפשרות הגדרת הרשאות לקטגוריה.
בתיבת הדו-שיח, לוחצים על אישור.
כך מוודאים שלחשבון השירות של הקטלוג יש את התפקיד "משתמש באובייקט אחסון" (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.