La modification d'une vue Apache Iceberg vous permet de faire évoluer le schéma et la définition SQL de la vue, ou de définir et de supprimer des propriétés de vue personnalisées, sans modifier l'identité de la vue dans le catalogue d'environnements d'exécution Lakehouse.
Il n'est pas possible de renommer une vue. Pour renommer une vue, créez une vue avec le nouveau nom, puis supprimez la vue d'origine. L'emplacement de stockage d'une vue est également immuable après sa création. Une mise à jour qui définit un autre emplacement échoue avec une erreur 400 Bad Request.
Avant de commencer
-
Vérifiez que la facturation est activée pour votre projet Google Cloud .
-
Activez l'API BigLake si ce n'est pas déjà fait.
Rôles requis pour activer les API
Pour activer des API, vous devez disposer de l'autorisation
serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles. - Configurez le catalogue d'environnements d'exécution Lakehouse avec le point de terminaison du catalogue REST Apache Iceberg.
- Consultez les limites des vues Iceberg.
- Créer une vue
Rôles requis
Pour obtenir les autorisations nécessaires pour modifier une vue, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet et votre bucket de stockage :
-
Modifier une vue : Éditeur BigLake (
roles/biglake.editor) - votre projet -
Écrire des fichiers de métadonnées de vue en mode d'identifiants de l'utilisateur final : Utilisateur d'objets Storage (
roles/storage.objectUser) – bucket Cloud Storage
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ces rôles prédéfinis contiennent les autorisations requises pour modifier une vue. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour modifier une vue :
-
Modifier une vue :
-
biglake.views.updatesur la vue -
biglake.tables.getsur chaque table Iceberg référencée par la définition de la nouvelle vue
-
-
Écrire des fichiers de métadonnées de vue en mode d'identifiants de l'utilisateur final :
storage.objects.createsur le bucket Cloud Storage
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Pour obtenir la liste complète des autorisations d'affichage, consultez Rôles et autorisations requis.
Remplacer une définition de vue
Remplacez le schéma et la logique SQL d'une vue existante. Lorsque vous remplacez une vue, le catalogue écrit un nouveau fichier metadata.json versionné (par exemple, 00001-UUID.metadata.json), ajoute une nouvelle version de vue et un nouveau schéma aux métadonnées de la vue, et conserve le view-uuid de la vue.
Spark
CREATE OR REPLACE VIEW my_ns.eng_employees (
emp_id,
emp_name,
dept,
salary,
is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';
REST
Pour mettre à jour une vue à l'aide de l'API REST, envoyez une requête POST au point de terminaison UpdateIcebergView :
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
Le corps de la requête doit contenir une charge utile JSON Iceberg CommitViewRequest valide avec les requirements et updates à appliquer. Le catalogue valide les exigences de simultanéité optimiste et valide les mises à jour dans un nouveau fichier metadata.json.
Remplacez les éléments suivants :
PROJECT_ID: ID de votre projet Google Cloud.CATALOG_ID: ID de votre catalogue.NAMESPACE_NAME: nom de l'espace de noms de votre catalogue.VIEW_NAME: nom de votre vue.
Définir et annuler la définition des propriétés de la vue
Définissez ou supprimez des propriétés personnalisées sur une vue sans modifier sa définition.
Spark
Définissez les propriétés :
ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');
Désactivez une propriété :
ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');
Pour savoir comment le catalogue gère les propriétés telles que write.metadata.compression-codec, consultez Afficher les propriétés.
REST
Envoyez une requête CommitViewRequest au point de terminaison UpdateIcebergView avec les mises à jour set-properties ou remove-properties. Consultez Remplacer une définition de vue pour connaître le chemin d'accès au point de terminaison.
Étapes suivantes
- Découvrez comment obtenir des informations sur une vue.
- Découvrez comment supprimer une vue.