Borrar (descartar) una vista de Apache Iceberg te permite quitar una vista que ya no necesitas del catálogo de tiempo de ejecución de Lakehouse. Cuando borras una vista, se quita su registro y se borra su política de Identity and Access Management (IAM), pero no se ven afectadas las tablas de Iceberg subyacentes ni sus datos.
No puedes borrar un espacio de nombres que aún contenga vistas. Descarta todas las vistas de un espacio de nombres antes de borrarlo.
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.
- Revisa las limitaciones de las vistas de Iceberg.
Roles obligatorios
Para obtener los permisos que necesitas para borrar una vista, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
-
Borrar una vista:
Editor de BigLake (
roles/biglake.editor) - tu proyecto
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para borrar una vista. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para borrar una vista:
-
Borrar una vista:
biglake.views.deleteen la vista
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Para obtener una lista completa de los permisos de lectura, consulta Roles y permisos necesarios.
Borrar una vista
Borrar una vista
Spark
DROP VIEW NAMESPACE_NAME.VIEW_NAME;
Para evitar un error si la vista no existe, usa DROP VIEW IF EXISTS:
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;
Reemplaza lo siguiente:
NAMESPACE_NAME: Es el nombre de tu espacio de nombres.VIEW_NAME: Es el nombre de tu vista.
REST
Para borrar una vista con la API de REST, realiza una solicitud DELETE al extremo DeleteIcebergView:
DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
Si la solicitud se ejecuta correctamente, se mostrará 204 No Content.
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.VIEW_NAME: Es el nombre de tu vista.
¿Qué sigue?
- Obtén información para crear una vista.
- Obtén información para borrar un espacio de nombres.