Modificar una vista de Apache Iceberg te permite desarrollar el esquema y la definición de SQL de la vista, o establecer y anular las propiedades de la vista personalizada, sin cambiar la identidad de la vista en el catálogo de tiempo de ejecución de Lakehouse.
No se admite cambiar el nombre de una vista. Para cambiar el nombre de una vista, crea una vista con el nombre
nuevo y, luego, borra la vista original. La
ubicación de almacenamiento de una vista también es inmutable después de la creación, y una actualización que
establece una ubicación diferente falla con un error 400 Bad Request.
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.
- Crea una vista.
Roles obligatorios
Para obtener los permisos que necesitas para modificar una vista, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto y bucket de almacenamiento:
-
Modifica una vista:
Editor de BigLake (
roles/biglake.editor): tu proyecto -
Escribe archivos de metadatos de vista en el modo de credenciales del usuario final:
Usuario de objetos de almacenamiento (
roles/storage.objectUser): el bucket de Cloud Storage
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 modificar una vista. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para modificar una vista:
-
Modifica una vista:
-
biglake.views.updateen la vista -
biglake.tables.geten cada tabla de Iceberg a la que hace referencia la definición de la vista nueva
-
-
Escribe archivos de metadatos de vista en el modo de credenciales del usuario final:
storage.objects.createen el bucket de Cloud Storage
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.
Reemplaza una definición de vista
Reemplaza el esquema y la lógica de SQL de una vista existente. Cuando reemplazas una vista,
el catálogo escribe un nuevo archivo metadata.json con versión (por ejemplo,
00001-UUID.metadata.json), agrega una nueva versión de la vista
y un esquema a los metadatos de la vista, y conserva el view-uuid de la vista.
Spark
CREATE OR REPLACE VIEW my_ns.eng_employees (
emp_id,
emp_name,
dept,
salary,
is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';
REST
Para actualizar una vista con la API de REST, realiza una solicitud POST al
extremo UpdateIcebergView:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
El cuerpo de la solicitud debe contener una carga útil de JSON CommitViewRequest de Iceberg válida con los valores requirements y updates que se aplicarán. El catálogo
valida los requisitos de simultaneidad optimista y confirma las actualizaciones
en un archivo metadata.json nuevo.
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.
Cómo establecer y anular las propiedades de las vistas
Establece o quita propiedades personalizadas en una vista sin cambiar su definición.
Spark
Establece las propiedades:
ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');
Anula una propiedad:
ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');
Para obtener detalles sobre cómo el catálogo maneja propiedades como
write.metadata.compression-codec, consulta Visualiza
propiedades.
REST
Envía un CommitViewRequest al extremo UpdateIcebergView con
actualizaciones de set-properties o remove-properties. Consulta Reemplaza una definición de vista para obtener la ruta de acceso del extremo.
¿Qué sigue?
- Obtén información para obtener detalles de las vistas.
- Obtén información para borrar una vista.