Crear un espacio de nombres en un catálogo (como un catálogo de REST de Apache Iceberg o un catálogo de Apache Hive) te ayuda a organizar tus tablas en el catálogo del entorno de ejecución de Lakehouse.
Antes de comenzar
-
Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .
-
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 permisoserviceusage.services.enable. Obtén más información para otorgar roles.
Roles obligatorios
Para obtener los permisos que necesitas para crear un espacio de nombres, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
-
Todos:
- Administrador de BigLake (
roles/biglake.admin) - Administrador de almacenamiento (
roles/storage.admin)
- Administrador de BigLake (
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 a través de roles personalizados o cualquier otro rol predefinido.
Crea un espacio de nombres
Crea un espacio de nombres dentro de un catálogo.
Console
En la consola de Google Cloud , abre la página Lakehouse.
Selecciona un catálogo existente o crea uno si no tienes.
En la barra de menú, haz clic en + Crear espacio de nombres.
En Nombre del espacio de nombres, ingresa un nombre único para tu espacio de nombres.
En Ubicación, selecciona un bucket de Cloud Storage para asociarlo con tu espacio de nombres.
Haz clic en Crear.
Se creará tu espacio de nombres y aparecerá en la lista de detalles del catálogo.
REST
Para crear un espacio de nombres con la API de REST, realiza una solicitud POST al extremo CreateIcebergNamespace:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces
El cuerpo de la solicitud debe contener una carga útil de JSON de CreateNamespaceRequest de Iceberg válida que defina el identificador y las propiedades del espacio de nombres.
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de Google Cloud .CATALOG_ID: Es el ID de tu catálogo del entorno de ejecución de Lakehouse.