Mengelola resource katalog REST Iceberg

Lakehouse untuk Apache Iceberg memungkinkan Anda mengelola endpoint katalog REST Apache Iceberg dalam katalog runtime Lakehouse. Anda dapat menggunakan konsol Google Cloud atau REST API untuk membuat, mengonfigurasi, dan memantau katalog ini guna membuat lapisan metadata yang diperlukan untuk koneksi mesin kueri.

Sebelum memulai

1. Baca Tentang katalog runtime Lakehouse untuk memahami cara kerja katalog runtime Lakehouse dan batasan untuk layanan ini.
Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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.

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.

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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna menggunakan katalog runtime Lakehouse, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

• Admin BigLake (roles/biglake.admin)
• Storage Admin (roles/storage.admin)

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.

Tindakan pengelolaan

Anda dapat melakukan tindakan pengelolaan berikut pada resource katalog REST Apache Iceberg menggunakan konsol Google Cloud atau REST API:

• Buat katalog: Buat endpoint pengelolaan katalog REST Apache Iceberg yang mengarah ke lokasi gudang Cloud Storage pokok (CreateIcebergCatalog).
• Memperbarui katalog: Mengupgrade katalog bucket Cloud Storage yang ada (katalog gs:// lama) ke katalog BigLake (katalog bl://) (UpdateIcebergCatalog).
• Buat namespace: Buat namespace dalam katalog REST Iceberg untuk mengelompokkan tabel terkait (CreateIcebergNamespace).
• Aktifkan penjualan kredensial: Alihkan metode autentikasi katalog yang ada ke mode penjualan kredensial untuk menjual token penyimpanan berumur pendek langsung ke mesin kueri (UpdateIcebergCatalog).
• Mendapatkan detail katalog: Lihat properti dan metadata untuk katalog Anda, termasuk URI katalog REST yang diperlukan untuk koneksi klien (GetIcebergCatalog).
• Mengelola ACL namespace: Lihat dan perbarui kebijakan IAM di namespace katalog Anda untuk mengontrol akses bagi pokok tertentu (get-iam-policy, set-iam-policy).
• Menghapus katalog: Batalkan pendaftaran endpoint pengelolaan metadata katalog dari katalog runtime Lakehouse (DeleteIcebergCatalog).
• Menghapus namespace: Hapus namespace dari katalog REST Iceberg Anda jika tidak diperlukan lagi (DeleteIcebergNamespace).
• Melihat log audit: Periksa Cloud Audit Logs untuk melihat catatan yang dapat diverifikasi dari aktivitas administratif dan akses data.

Harga

Untuk mengetahui detail harga, lihat harga Lakehouse untuk Apache Iceberg.

Langkah berikutnya

• Pelajari cara mengelola ACL namespace.
• Pelajari lebih lanjut endpoint katalog REST Apache Iceberg.