Katalog runtime Lakehouse memungkinkan Anda memeriksa konfigurasi dan metadata endpoint katalog di Lakehouse tanpa batas. Untuk endpoint katalog REST Apache Iceberg, Anda dapat mengambil URI katalog REST yang diperlukan untuk koneksi klien, metode autentikasi, dan akun layanan terkait. Untuk mengetahui informasi selengkapnya tentang endpoint katalog, lihat Jenis katalog dan konfigurasi endpoint.
Sebelum memulai
- Baca Tentang katalog runtime Lakehouse untuk memahami cara kerja katalog runtime Lakehouse dan batasan untuk layanan ini.
- 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.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk melihat detail endpoint katalog, minta administrator untuk memberi Anda peran IAM berikut di project Anda:
-
Semua:
- Admin BigLake (
roles/biglake.admin) - Storage Admin (
roles/storage.admin)
- Admin BigLake (
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Mendapatkan detail endpoint katalog
Memeriksa konfigurasi dan properti endpoint katalog.
Konsol
Di konsol Google Cloud , buka halaman Lakehouse.
Klik nama katalog mana pun.
Di halaman Catalog Details, pelajari informasi tentang katalog seperti ID katalog, stempel waktu pembuatan, URI katalog REST, metode autentikasi, dan akun layanan.
Untuk katalog gabungan, halaman Catalog Details juga menampilkan properti berikut saat dikonfigurasi:
- Identity mode: Menampilkan
Service identityatauUser identity federationuntuk koneksi Databricks Unity Catalog. - Service directory name: Menampilkan nama resource layanan Direktori Layanan yang dikonfigurasi untuk transportasi kueri pribadi di koneksi AWS Glue, Snowflake Horizon Catalog, dan Databricks Unity Catalog.
- Metadata service directory name: Menampilkan nama resource layanan Direktori Layanan yang dikonfigurasi untuk pemuatan ulang metadata latar belakang pribadi pada koneksi AWS Glue, Snowflake Horizon Catalog, dan Databricks Unity Catalog.
- Identity mode: Menampilkan
gcloud
Untuk mendeskripsikan endpoint katalog menggunakan Google Cloud CLI, jalankan perintah gcloud biglake iceberg catalogs describe.
gcloud biglake iceberg catalogs describe CATALOG_ID \ --project="PROJECT_ID"
Ganti kode berikut:
CATALOG_ID: ID katalog Anda.PROJECT_ID: Project ID Google Cloud Anda.
REST
Untuk mengambil detail dan konfigurasi endpoint katalog menggunakan REST API, buat permintaan GET
ke endpoint GetIcebergCatalog:
GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID
Respons berisi objek JSON IcebergCatalog yang menjelaskan konfigurasi katalog.
Ganti kode berikut:
PROJECT_ID: Project ID Google Cloud Anda.CATALOG_ID: ID katalog Anda.