Obtén detalles del catálogo

La recuperación de las propiedades de configuración expone los metadatos de Lakehouse para Apache Iceberg.

En el catálogo de entorno de ejecución de Lakehouse, la inspección de un catálogo existente (como un catálogo de REST de Apache Iceberg o un catálogo de Apache Hive) revela sus detalles. En el caso de los catálogos REST de Apache Iceberg, esto incluye el URI del catálogo REST necesario para las conexiones del cliente, el método de autenticación y la cuenta de servicio asociada.

Antes de comenzar

  1. Lee Acerca del catálogo de entorno de ejecución de Lakehouse para comprender cómo funciona el catálogo de entorno de ejecución de Lakehouse y las limitaciones del servicio.
    2. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

    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.

    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.

    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

Roles obligatorios

Para obtener los permisos que necesitas y ver los detalles del catálogo, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Obtén detalles del catálogo

Inspecciona la configuración y las propiedades del catálogo.

Console

  1. En la consola de Google Cloud , abre la página Lakehouse.

    Ir a Lakehouse

  2. Haz clic en el nombre de cualquier catálogo.

  3. En la página Detalles del catálogo, explora la información sobre el catálogo, como el ID, la marca de tiempo de creación, el URI del catálogo de REST, el método de autenticación y la cuenta de servicio.

gcloud

Para describir un catálogo con gcloud, ejecuta el comando gcloud biglake iceberg catalogs describe.

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

Reemplaza lo siguiente:

  • CATALOG_ID: Es el ID de tu catálogo.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud .

REST

Para recuperar los detalles y la configuración del catálogo con la API de REST, realiza una solicitud GET al extremo GetIcebergCatalog:

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

La respuesta contiene un objeto JSON IcebergCatalog que describe la configuración del catálogo.

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • CATALOG_ID: Es el ID de tu catálogo.