Modifica una vista

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

  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 más 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.
  4. Revisa las limitaciones de las vistas de Iceberg.
  5. 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.update en la vista
    • biglake.tables.get en 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.create en 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?