La lista de vistas te permite ver qué vistas de Apache Iceberg están registradas en un espacio de nombres del catálogo de tiempo de ejecución de Lakehouse. El resultado contiene solo identificadores de vistas; las tablas se excluyen, y las tablas de listas también excluyen las vistas.
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 enumerar vistas, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
-
Vistas de lista:
Visualizador de BigLake (
roles/biglake.viewer): 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 enumerar vistas de lista. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para enumerar las vistas de lista:
-
Vistas de lista:
biglake.views.listen el espacio de nombres
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.
Vistas de lista
Enumera las vistas en un espacio de nombres.
Spark
SHOW VIEWS IN NAMESPACE_NAME;
Reemplaza NAMESPACE_NAME por el nombre de tu
espacio de nombres.
REST
Para enumerar las vistas de lista con la API de REST, realiza una solicitud GET al extremo ListIcebergViewIdentifiers:
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views
El extremo admite los parámetros de consulta pageToken y pageSize.
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.
¿Qué sigue?
- Obtén información para obtener detalles de las vistas.
- Obtén información para consultar una vista.