Lorsque vous créez, interrogez, modifiez ou supprimez des vues Apache Iceberg dans le catalogue d'environnements d'exécution Lakehouse, vous pouvez rencontrer des erreurs telles que des conflits de noms avec des tables, des refus d'accès, des requêtes temporelles sur une vue, des instantanés arrivés à expiration, des types de catalogues non compatibles ou un emplacement de vue immuable. Ce document vous aide à identifier la cause de ces erreurs courantes et à les résoudre. Pour les problèmes généraux liés au catalogue, consultez Dépannage.
409 Conflict ou AlreadyExistsException lors de la création ou du remplacement d'une vue ou d'une table
Les tables et les vues partagent le même espace de noms d'identifiant dans un espace de noms de catalogue, et le catalogue bloque les écrasements entre types. Vous ne pouvez pas créer une vue portant le même nom qu'une table existante, ni une table portant le même nom qu'une vue existante.
Pour identifier le conflit de noms, listez les tables et les vues de l'espace de noms :
SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;
Choisissez un autre nom ou supprimez d'abord l'objet en conflit.
403 Forbidden ou AccessDeniedException sur les opérations d'affichage
Étant donné que votre moteur de calcul évalue les vues côté client, l'interrogation d'une vue nécessite des autorisations sur la vue et sur chaque table à laquelle la vue fait référence. Effectuez les vérifications suivantes :
- Pour le LDD de vue, l'appelant dispose du rôle Éditeur BigLake (
roles/biglake.editor) ou Administrateur BigLake (roles/biglake.admin). - Pour les requêtes
SELECT, l'appelant dispose du rôle Lecteur BigLake (roles/biglake.viewer), qui accorde l'autorisationbiglake.views.getsur la vue, et les autorisationsbiglake.tables.getetbiglake.tables.getDatasur les tables référencées. - En mode d'identifiants de l'utilisateur final, l'appelant dispose du rôle Utilisateur d'objets Storage (
roles/storage.objectUser) sur le bucket Cloud Storage pour afficher le LDD, ou du rôle Lecteur d'objets Storage (roles/storage.objectViewer) pour les requêtes en lecture seule. - En mode de distribution des identifiants, le compte de service du catalogue dispose du rôle Utilisateur d'objets Storage (
roles/storage.objectUser) sur le bucket Cloud Storage, et Spark est configuré avecspark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials.
Pour en savoir plus, consultez Rôles et autorisations requis.
UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW
Spark renvoie AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW]
Cannot time travel on view lorsqu'une requête applique TIMESTAMP AS OF ou VERSION AS OF directement à un identifiant de vue.
Supprimez la clause de voyage temporel de la requête. Si vous avez besoin de données historiques, définissez une vue dont la définition SQL applique TIMESTAMP AS OF à la table sous-jacente, ou utilisez une CTE qui interroge directement la table sous-jacente. Pour en savoir plus, consultez Créer une vue avec la fonctionnalité temporelle sur les tables sous-jacentes.
ValidationException: Cannot find snapshot older than timestamp
Une vue définie avec une clause de fonctionnalité temporelle fait référence à un instantané qui a expiré ou qui a été supprimé de la table sous-jacente.
Remplacez la vue par CREATE OR REPLACE VIEW en utilisant un code temporel ou un ID d'instantané plus récent, ou ajustez les paramètres de conservation des instantanés sur la table Iceberg sous-jacente.
409 Conflict: Namespace is not empty lors de la suppression d'un espace de noms
Vous ne pouvez pas supprimer un espace de noms qui contient encore des vues. Répertoriez et supprimez les vues restantes, puis supprimez l'espace de noms :
SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;
400 Bad Request avec FAILED_PRECONDITION sur les opérations d'affichage
Les vues Iceberg ne sont compatibles qu'avec les catalogues à buckets multiples et les catalogues à bucket unique. Le catalogue rejette les opérations d'affichage sur les catalogues BigQuery ou les catalogues fédérés. Créez la vue dans un type de catalogue compatible.
400 Bad Request: View location is immutable
Vous ne pouvez pas modifier l'emplacement de stockage d'une vue après l'avoir créée. Supprimez la mise à jour de la position de votre demande.
Dans Trino 481 et versions antérieures, CREATE OR REPLACE VIEW envoie une notification de position qui déclenche cette erreur. Passez à Trino 482 ou version ultérieure, ou exécutez DROP VIEW suivi de CREATE VIEW pour mettre à jour la définition de la vue. Pour en savoir plus, consultez Compatibilité avec Trino.
Étapes suivantes
- Consultez la présentation des vues Apache Iceberg.
- Découvrez comment créer une vue.