Si borras o quitas una tabla, solo se quitarán el registro y los metadatos de la tabla del catálogo del entorno de ejecución de Lakehouse. Los archivos de datos subyacentes almacenados en Cloud Storage no se purgan ni se borran.
Puedes borrar una tabla con la Google Cloud consola de, los comandos SQL drop en Spark
y Trino, o la especificación de la API de Iceberg REST Catalog de código abierto (DELETE /v1/{prefix}/namespaces/{namespace}/tables/{table}).
Antes de comenzar
Consulta la descripción general de la tabla para comprender los diferentes tipos de tablas y las implicaciones de usarlas.
-
Verifica que la facturación esté habilitada para tu Google Cloud proyecto.
-
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 permisoserviceusage.services.enable. Obtén más información para otorgar roles.
Roles obligatorios
Para obtener los permisos que necesitas para borrar una tabla, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
-
Todos:
Administrador de BigLake (
roles/biglake.admin) - 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.
Borra una tabla
Borrar una tabla
Console
En la Google Cloud consola de, ve a Lakehouse.
Selecciona un catálogo existente o crea uno si no tienes.
En la tabla Detalles del espacio de nombres, selecciona una tabla y expande las opciones del menú.
Haz clic en Borrar.
Para confirmar la eliminación, ingresa el nombre de la tabla en el cuadro de diálogo.
Haz clic en Borrar.
Spark
spark.sql("DROP TABLE TABLE_NAME;")
Trino
DROP TABLE TABLE_NAME;
REST
Para borrar un registro de tabla de Iceberg con la API de REST, realiza una solicitud DELETE al extremo DeleteIcebergTable:
DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del Google Cloud proyecto.CATALOG_ID: Es el ID de tu catálogo del entorno de ejecución de Lakehouse.NAMESPACE_NAME: Es el nombre del espacio de nombres de tu catálogo.TABLE_NAME: Es el nombre de tu tabla de Iceberg.
¿Qué sigue?
- Consulta el catálogo de REST de Apache Iceberg.