Actualizar un catálogo

Actualizar un catálogo (como un catálogo de REST de Apache Iceberg) te permite modificar sus propiedades, como el modo de credenciales, la ubicación predeterminada del almacén o el tipo de catálogo subyacente. Por ejemplo, puedes actualizar un catálogo heredado de bucket de Cloud Storage (catálogo gs://) a un catálogo de BigLake (catálogo bl://).

Antes de comenzar

  1. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  2. 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 permiso serviceusage.services.enable. Obtén más información para otorgar roles.

    Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para actualizar un catálogo, pídele a tu administrador que te otorgue los siguientes roles de IAM:

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.

Actualizar un catálogo

Puedes actualizar la configuración de un catálogo, como modificar su descripción, el modo de credenciales o las ubicaciones permitidas.

Además, puedes actualizar un catálogo existente de bucket de Cloud Storage (catálogo heredado gs://) a un catálogo de BigLake (catálogo bl://). El catálogo actualizado conserva el nombre del bucket original. Después de la actualización, puedes asociar varios buckets y configurar ubicaciones restringidas.

Puedes actualizar un catálogo con la Google Cloud consola, gcloud, o la API de REST.

Console

  1. En la Google Cloud consola, abre la Lakehouse.

    Ir a Lakehouse

  2. En la fila del catálogo que deseas actualizar, haz clic en Más acciones del catálogo > Editar.

  3. En Configuración del catálogo, modifica la configuración que deseas actualizar.

  4. Selecciona Guardar.

gcloud

Usa el comando gcloud beta biglake iceberg catalogs update.

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    [--description="DESCRIPTION"] \
    [--credential-mode="CREDENTIAL_MODE"] \
    [--restricted-locations="RESTRICTED_LOCATIONS"] \
    [--catalog-type=biglake]

Reemplaza lo siguiente:

  • CATALOG_ID: Es el ID de tu catálogo de entorno de ejecución de Lakehouse.
  • PROJECT_ID: Es el ID del Google Cloud proyecto de.
  • DESCRIPTION: Es una descripción del catálogo (opcional).
  • CREDENTIAL_MODE: Es el método de autenticación (opcional). Usa end-user para Credenciales de usuario final o vended-credentials para Modo de venta de credenciales.
  • RESTRICTED_LOCATIONS: Es una lista separada por comas de buckets o rutas de almacenamiento permitidos adicionales (opcional).

REST

Para modificar un catálogo o actualizar su tipo con la API de REST, haz una PATCH solicitud al UpdateIcebergCatalog extremo con el updateMask adecuado:

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=icebergCatalog.catalogType,icebergCatalog.description

El cuerpo de la solicitud debe contener una carga útil JSON IcebergCatalog con los campos que se actualizarán:

{
  "catalogType": "BIGLAKE",
  "description": "Updated catalog description"
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del Google Cloud proyecto de.
  • CATALOG_ID: Es el ID de tu catálogo de entorno de ejecución de Lakehouse.