Borra una tabla

Si borras o descartas una tabla, solo se quitan 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 borran ni se eliminan.

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

Antes de comenzar

  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

  3. Configura el catálogo del entorno de ejecución de Lakehouse con el extremo del catálogo 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:

  • 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 mediante roles personalizados o cualquier otro rol predefinido.

Capacidades y asistencia de tablas

Cuando usas tablas en el catálogo del entorno de ejecución de Lakehouse, es útil comprender los diferentes tipos de tablas y sus capacidades de participación. Para obtener más información sobre el uso de tablas de Apache Iceberg específicamente, 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 (vista previa). No se admiten las tablas de Iceberg V1. Para actualizar las tablas V1 existentes, consulta Actualiza las tablas de Iceberg V1 a V2.

Usa opciones de tabla (vista previa)

Puedes habilitar el uso de las capacidades administradas de BigQuery, como el lenguaje de manipulación de datos (DML) de BigQuery y la administración automática de tablas, mediante la configuración de propiedades de tabla específicas. 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 la función, debes configurar explícitamente las propiedades de la tabla. Consulta Configura las opciones de tabla options 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 capacidades administradas de BigQuery. Consulta Configura las opciones de tabla para comprender cómo la eliminación de tablas interactúa con los trabajos de administración de tablas en segundo plano.

Borra una tabla

Borrar una tabla

Console

  1. En la Google Cloud consola de, 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 gcloud biglake iceberg tables delete comando.

gcloud biglake iceberg tables delete TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

Reemplaza lo siguiente:

  • TABLE_NAME: Es el nombre de tu tabla de Iceberg.
  • PROJECT_ID: Es el ID del Google Cloud proyecto de.
  • 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 del entorno de ejecución de Lakehouse desde BigQuery, usa la siguiente instrucción DROP TABLE de GoogleSQL:

DROP TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del Google Cloud proyecto de.
  • CATALOG_ID: Es el ID del catálogo del entorno de ejecución de Lakehouse.
  • NAMESPACE: Es el nombre del espacio de nombres de Iceberg.
  • TABLE_NAME: Es el nombre de tu tabla de Iceberg.

REST

Para borrar un registro de tabla de Iceberg con la API de REST, realiza una DELETE solicitud al DeleteIcebergTable extremo:

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 de.
  • CATALOG_ID: Es el ID de tu catálogo.
  • 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?