קבלת פרטי קטלוג

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

עבור נקודות קצה של קטלוג REST של Apache Iceberg, אפשר לאחזר את ה-URI של קטלוג REST שנדרש לחיבורי לקוח, את שיטת האימות ואת חשבון השירות המשויך.

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

1. כדאי לקרוא את המאמר מידע על קטלוג זמן הריצה של Lakehouse כדי להבין איך קטלוג זמן הריצה של Lakehouse פועל ומהן המגבלות של השירות.
נכנסים לחשבון 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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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 הבאים בפרויקט:

• הכול:
  • אדמין ב-BigLake (roles/biglake.admin)
  • אדמין באחסון (roles/storage.admin)

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

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

קבלת פרטי קטלוג

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

המסוף

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

   מעבר אל Lakehouse

2. לוחצים על השם של קטלוג כלשהו.

3. בדף פרטי הקטלוג אפשר לעיין במידע על הקטלוג, כמו מזהה הקטלוג, חותמת הזמן של היצירה, URI של קטלוג REST, שיטת האימות וחשבון השירות.

gcloud

כדי לתאר קטלוג באמצעות gcloud, מריצים את הפקודה gcloud biglake iceberg catalogs describe.

gcloud biglake iceberg catalogs describe CATALOG_ID \
    --project="PROJECT_ID"

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

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

REST

כדי לאחזר פרטים והגדרות של קטלוג באמצעות API בארכיטקטורת REST, שולחים בקשת GET לנקודת הקצה GetIcebergCatalog:

GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID

התגובה מכילה אובייקט IcebergCatalog JSON שמתאר את הגדרות הקטלוג.

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

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