Administra tablas del catálogo de REST de Iceberg de Lakehouse

Lakehouse para Apache Iceberg admite la creación, la administración y la consulta de tablas de catálogo de REST de Lakehouse Iceberg almacenadas en Cloud Storage.

Administradas a través del catálogo de entorno de ejecución de Lakehouse, BigQuery y los motores de código abierto conectados pueden leer estas tablas. Las operaciones de escritura permanecen restringidas al motor específico que creó la tabla originalmente. Además de las integraciones del motor de consultas, el catálogo de entorno de ejecución de Lakehouse implementa la especificación de la API de REST de Iceberg de código abierto, lo que permite que los clientes de REST compatibles interactúen directamente con los recursos de la tabla.

Antes de comenzar

Consulta la descripción general de la tabla para comprender los diferentes tipos de tablas y las implicaciones de usarlas.

  1. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  2. Habilita la API de BigLake.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

    Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para administrar las tablas de catálogo de REST de Lakehouse Iceberg, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto y bucket de almacenamiento:

  • Crear y eliminar tablas:
    • Administrador de BigLake (roles/biglake.admin) - el proyecto
    • Administrador de almacenamiento (roles/storage.admin) - el bucket de Cloud Storage
  • Leer datos de tablas en el modo de venta de credenciales: Visualizador de BigLake (roles/biglake.viewer) - el proyecto
  • Escribir datos de tablas en el modo de venta de credenciales : Editor de BigLake (roles/biglake.editor) - el proyecto
  • Leer datos de tablas en el modo de venta de credenciales:
    • Visualizador de BigLake (roles/biglake.viewer) - el proyecto
    • Visualizador de objetos de almacenamiento (roles/storage.objectViewer) - el bucket de Cloud Storage
  • Escribir datos de tablas en el modo de venta de credenciales:
    • Editor de BigLake (roles/biglake.editor) - el proyecto
    • Usuario de objetos de almacenamiento (roles/storage.objectUser) - el bucket de Cloud Storage

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.

Acciones de administración

Puedes realizar las siguientes acciones de administración en tus tablas de catálogo de REST de Lakehouse Iceberg:

  • Crear una tabla: Crea una tabla de Apache Iceberg dentro de un espacio de nombres del catálogo con la Google Cloud consola de, Spark, Trino o la API de REST de Iceberg Catalog (CreateIcebergTable).
  • Enumerar tablas: Visualiza los identificadores de tablas dentro de un espacio de nombres con la Google Cloud consola de, Spark, Trino o la API de REST de Iceberg Catalog (ListIcebergTableIdentifiers).
  • Obtener detalles de la tabla: Inspecciona el esquema, las propiedades y las credenciales de la tabla con la Google Cloud consola de, Spark, Trino o la API de REST de Iceberg Catalog (GetIcebergTable, LoadIcebergTableCredentials).
  • Insertar datos: Agrega filas de datos a tus tablas de Iceberg con Spark o Trino.
  • Consultar una tabla: Ejecuta consultas en tus tablas de Iceberg desde Spark, Trino o BigQuery con nombres de tablas de cuatro partes.
  • Modificar una tabla: Desarrolla el esquema de la tabla y actualiza las propiedades de los metadatos con la Google Cloud consola de, Spark, Trino o la API de REST de Iceberg Catalog (UpdateIcebergTable).
  • Borrar una tabla: Quita el registro de una tabla del catálogo sin borrar los archivos de almacenamiento subyacentes con la Google Cloud consola de, Spark, Trino o la API de REST de Iceberg Catalog (DeleteIcebergTable).

¿Qué sigue?