Borra una tabla

Borrar o descartar una tabla solo quita el registro y los metadatos de la tabla del catálogo de entorno de ejecución de Lakehouse. Los archivos de datos subyacentes almacenados en Cloud Storage no se borran ni se limpian.

Puedes borrar una tabla con la consola de Google Cloud , los comandos de eliminación de SQL en Spark y Trino, o la API de REST.

Antes de comenzar

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

  2. 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 información para otorgar roles.

    Habilitar la API

  3. 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 opciones de tablas (versión preliminar)

Puedes habilitar el uso de las funciones administradas de 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. Consulta Configura las opciones de la tabla para obtener más información.

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 funciones 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

  1. En la consola de Google Cloud , ve a Lakehouse.

    Ir a Lakehouse

  2. Selecciona un catálogo existente o crea uno si no tienes.

  3. En la tabla Detalles del espacio de nombres, selecciona una tabla y expande las opciones del menú.

  4. Haz clic en Borrar.

  5. Para confirmar la eliminación, ingresa el nombre de la tabla en el cuadro de diálogo.

  6. 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 de tu 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 sentencia 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 del catálogo del entorno de ejecución de Lakehouse.
  • NAMESPACE: Es el nombre de tu espacio de nombres 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 de tu catálogo.
  • TABLE_NAME: el nombre de tu tabla de Iceberg.

¿Qué sigue?