Mendapatkan detail endpoint katalog

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

  1. Baca Tentang katalog runtime Lakehouse untuk memahami cara kerja katalog runtime Lakehouse dan batasan untuk layanan ini.
  2. 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.

    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

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:

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

  1. Di konsol Google Cloud , buka halaman Lakehouse.

    Buka Lakehouse

  2. Klik nama katalog mana pun.

  3. 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 identity atau User identity federation untuk 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.

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.