El catálogo de tiempo de ejecución de Lakehouse te permite borrar tablas de Apache Iceberg para limpiar las entradas no utilizadas o inactivas. Esta operación quita el registro y los metadatos de la tabla, pero no borra los archivos de datos subyacentes en Cloud Storage.
Puedes borrar una tabla con la consola de Google Cloud , las sentencias de SQL deDROP TABLE
en Apache Spark o BigQuery, Google Cloud CLI
o la API de REST.
Antes de comenzar
-
Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .
-
Habilita la API de BigLake si aún no está habilitada.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles. - Configura el catálogo de tiempo de ejecución de Lakehouse con el extremo del catálogo de REST de Apache Iceberg.
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:
-
Borrar una tabla:
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.
Funciones y compatibilidad de las tablas
Cuando usas tablas en el catálogo de tiempo de ejecución de Lakehouse, es útil comprender los diferentes tipos de tablas y sus capacidades de habilitación. Para obtener más información sobre el uso de tablas de Apache Iceberg, consulta Descripción general de las tablas de Apache Iceberg.
Tablas de Iceberg compatibles
Solo se admiten las tablas de Apache Iceberg V2 (DG) y V3 (versión preliminar). Las tablas de Iceberg V1 no son compatibles. Para actualizar las tablas V1 existentes, consulta Actualiza las tablas de Iceberg V1 a V2.
Usa las opciones de tabla (versión preliminar)
Puedes habilitar el uso de las funciones administradas por BigQuery, como el lenguaje de manipulación de datos (DML) de BigQuery y la administración automática de tablas, configurando propiedades específicas de las tablas. Estas funciones se habilitan de diferentes maneras según dónde se cree la tabla:
- Desde BigQuery: El DML de BigQuery y la administración automática de tablas están habilitados de forma predeterminada.
- Desde motores de código abierto: Para habilitar esta opción, debes configurar de forma explícita las propiedades de la tabla. Para obtener más información, consulta Configura las opciones de la tabla.
Si borras un registro de tabla del catálogo, se quita la tabla, independientemente de si es una tabla de Iceberg estándar o una tabla habilitada para las capacidades administradas de BigQuery. Consulta Configura las opciones de la tabla para comprender cómo interactúa la eliminación de tablas con los trabajos de administración de tablas en segundo plano.
Borra una tabla
Borrar una tabla
Console
En la consola de Google Cloud , ve a la página Lakehouse.
Selecciona el catálogo que contiene la tabla que deseas borrar.
Selecciona el espacio de nombres que contiene la tabla.
Borra la tabla con uno de los siguientes métodos:
- En la fila de la tabla que deseas borrar, haz clic en Acciones > Borrar.
- Haz clic en el nombre de la tabla y, luego, en la barra de herramientas, haz clic en Borrar tabla.
En el diálogo de confirmación, ingresa
deletey, luego, haz clic en Borrar.
Spark
spark.sql("DROP TABLE TABLE_NAME;")
DROP TABLE TABLE_NAME;
gcloud
Para borrar una tabla con gcloud, ejecuta el
comando gcloud biglake iceberg tables delete.
gcloud biglake iceberg tables delete TABLE_NAME \ --project="PROJECT_ID" \ --catalog="CATALOG_ID" \ --namespace="NAMESPACE_NAME"
Reemplaza lo siguiente:
TABLE_NAME: el nombre de tu tabla de Iceberg.PROJECT_ID: Es el ID del proyecto de Google Cloud.CATALOG_ID: Es el ID de tu catálogo.NAMESPACE_NAME: Es el nombre del espacio de nombres del catálogo.
BigQuery
Para borrar un registro de tabla de Apache Iceberg en el
catálogo de tiempo de ejecución de Lakehouse desde BigQuery, usa
la siguiente declaración DROP TABLE de GoogleSQL:
DROP TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de Google Cloud.CATALOG_ID: Es el ID de tu catálogo.NAMESPACE: el nombre del espacio de nombres de la tabla de Iceberg.TABLE_NAME: el nombre de tu tabla de Iceberg.
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 proyecto de Google Cloud.CATALOG_ID: Es el ID de tu catálogo.NAMESPACE_NAME: Es el nombre del espacio de nombres del catálogo.TABLE_NAME: el nombre de tu tabla de Iceberg.