Mettre à jour un catalogue

La mise à jour d'un catalogue (tel qu'un catalogue REST Apache Iceberg) vous permet de modifier ses propriétés, telles que son mode d'identifiants, l'emplacement par défaut de l'entrepôt ou son type de catalogue sous-jacent. Par exemple, vous pouvez mettre à niveau un catalogue de bucket Cloud Storage hérité (catalogue gs://) vers un catalogue BigLake (catalogue bl://).

Avant de commencer

  1. Vérifiez que la facturation est activée pour votre Google Cloud projet.

  2. Activez l'API BigLake.

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

    Activer l'API

Rôles requis

Pour obtenir les autorisations dont vous avez besoin pour mettre à jour un catalogue, demandez à votre administrateur de vous attribuer les rôles IAM suivants :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Mettre à jour un catalogue

Vous pouvez mettre à jour la configuration d'un catalogue, par exemple en modifiant sa description, son mode d'identifiants ou les emplacements autorisés.

Vous pouvez également mettre à niveau un catalogue de bucket Cloud Storage existant (catalogue gs:// hérité) vers un catalogue BigLake (catalogue bl://). Le catalogue mis à niveau conserve le nom du bucket d'origine. Après la mise à niveau, vous pouvez associer plusieurs buckets et configurer des emplacements restreints.

Vous pouvez mettre à jour un catalogue à l'aide de la Google Cloud console, gcloud, ou de l'API REST.

Console

  1. Dans la Google Cloud console, ouvrez la page Lakehouse.

    Accéder à Lakehouse

  2. Sur la ligne du catalogue que vous souhaitez mettre à jour, cliquez sur Autres actions sur le catalogue > Modifier.

  3. Sous Configuration du catalogue, modifiez les paramètres que vous souhaitez mettre à jour.

  4. Sélectionnez Enregistrer.

gcloud

Exécutez la commande 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]

Remplacez les éléments suivants :

  • CATALOG_ID : ID de votre catalogue d'exécution Lakehouse.
  • PROJECT_ID: ID de votre Google Cloud projet.
  • DESCRIPTION : (facultatif) description du catalogue.
  • CREDENTIAL_MODE : (facultatif) méthode d'authentification. Utilisez end-user pour les identifiants de l'utilisateur final ou vended-credentials pour le mode de distribution d'identifiants.
  • RESTRICTED_LOCATIONS : (facultatif) liste de buckets ou de chemins d'accès de stockage supplémentaires autorisés, séparés par une virgule.

REST

Pour modifier un catalogue ou mettre à niveau son type à l'aide de l'API REST, envoyez une PATCH requête au point de terminaison UpdateIcebergCatalog avec le updateMask approprié :

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

Le corps de la requête doit contenir une charge utile JSON IcebergCatalog avec les champs à mettre à jour :

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

Remplacez les éléments suivants :

  • PROJECT_ID: ID de votre Google Cloud projet.
  • CATALOG_ID : ID de votre catalogue d'exécution Lakehouse.