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 de un solo bucket (gs://) a un tipo de catálogo de varios buckets (bl://) (recomendado). Actualizar tu catálogo proporciona beneficios significativos, como permitir que abarque varios buckets de almacenamiento.

Antes de comenzar

  1. Lee Acerca del catálogo de entorno de ejecución de Lakehouse para comprender cómo funciona el catálogo de entorno de ejecución de Lakehouse y las limitaciones del servicio.
    2. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the 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 un catálogo con la consola de Google Cloud , gcloud o la API de REST.

Console

  1. En la consola de Google Cloud , abre la página 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 los parámetros de configuración que quieras actualizar.

  4. Selecciona Guardar.

gcloud

Opción 1: Actualiza las propiedades del catálogo

Para actualizar las propiedades del catálogo (como la descripción o las ubicaciones restringidas), ejecuta 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"]

Reemplaza lo siguiente:

  • CATALOG_ID: Es el ID de tu catálogo del entorno de ejecución de Lakehouse.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • DESCRIPTION: Es una descripción del catálogo (opcional).
  • CREDENTIAL_MODE: (Opcional) Es el método de autenticación. Usa end-user para Credenciales de usuario final o vended-credentials para el Modo de venta de credenciales.
  • RESTRICTED_LOCATIONS: (Opcional) Es una lista separada por comas de rutas de acceso o buckets de almacenamiento permitidos adicionales. Precaución: Si especificas varias rutas o buckets superpuestos, esto puede provocar conflictos de metadatos, sobrescrituras accidentales de datos o problemas de seguridad, como filtraciones de permisos.

Opción 2: Actualiza un catálogo de un solo bucket (gs://) a un catálogo de varios buckets (bl://) (recomendado)

Para actualizar un catálogo existente de un solo bucket (gs://) a un catálogo de varios buckets (bl://) (recomendado), ejecuta el comando gcloud beta biglake iceberg catalogs update y establece el parámetro --catalog-type en biglake:

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    --catalog-type="biglake"

REST

Opción 1: Actualiza las propiedades del catálogo

Para modificar las propiedades de un catálogo (como su descripción) con la API de REST, haz una solicitud PATCH al extremo UpdateIcebergCatalog con el updateMask adecuado:

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

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

{
  "description": "Updated catalog description"
}

Opción 2: Actualiza un catálogo de un solo bucket (gs://) a un catálogo de varios buckets (bl://) (recomendado)

Para actualizar su tipo con la API de REST, realiza una solicitud PATCH al extremo UpdateIcebergCatalog con el catalogType en el updateMask:

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

El cuerpo de la solicitud debe contener una carga útil de JSON IcebergCatalog con el nuevo tipo de catálogo:

{
  "catalogType": "BIGLAKE"
}

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.