Ao criar, consultar, alterar ou excluir visualizações do Apache Iceberg no catálogo do ambiente de execução do Lakehouse, podem ocorrer erros como conflitos de nome com tabelas, negações de acesso, viagem no tempo em uma visualização, snapshots expirados, tipos de catálogo não compatíveis ou um local de visualização imutável. Este documento ajuda a identificar a causa desses erros comuns e a resolvê-los. Para problemas gerais de catálogo, consulte Solução de problemas.
409 Conflict ou AlreadyExistsException ao criar ou substituir uma visualização ou tabela
As tabelas e as visualizações compartilham o mesmo namespace de identificador em um namespace de catálogo, e o catálogo bloqueia substituições entre tipos. Não é possível criar uma visualização com o mesmo nome de uma tabela atual ou uma tabela com o mesmo nome de uma visualização atual.
Para encontrar a colisão de nomes, liste as tabelas e as visualizações no namespace:
SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;
Escolha outro nome ou remova o objeto conflitante primeiro.
403 Forbidden ou AccessDeniedException em operações de visualização
Como o Compute Engine avalia as visualizações no lado do cliente, para consultar uma visualização, é preciso ter permissões nela e em todas as tabelas que ela referencia. Confirme o seguinte:
- Para a DDL de visualização, o autor da chamada tem o papel de Editor do BigLake (
roles/biglake.editor) ou Administrador do BigLake (roles/biglake.admin). - Para consultas
SELECT, o autor da chamada tem o papel de Leitor do BigLake (roles/biglake.viewer), que concedebiglake.views.getna visualização ebiglake.tables.getebiglake.tables.getDatanas tabelas referenciadas. - No modo de credenciais do usuário final, o autor da chamada tem o papel de Usuário de objetos do Storage
(
roles/storage.objectUser) no bucket do Cloud Storage para visualizar a DDL ou o papel de Leitor de objetos do Storage (roles/storage.objectViewer) para consultas somente leitura. - No modo de venda de credenciais, a conta de serviço do catálogo tem o papel de Usuário de objetos do Storage (
roles/storage.objectUser) no bucket do Cloud Storage, e o Spark é configurado comspark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials.
Para mais informações, consulte Papéis e permissões necessários.
UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW
O Spark retorna AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW]
Cannot time travel on view quando uma consulta aplica TIMESTAMP AS OF ou
VERSION AS OF diretamente a um identificador de visualização.
Remova a cláusula de viagem no tempo da consulta. Se você precisar de dados históricos,
defina uma visualização com uma definição de SQL que aplique TIMESTAMP AS OF à tabela
subjacente ou use uma CTE que consulte a tabela subjacente diretamente. Para mais
informações, consulte Criar uma visualização com viagem no tempo em tabelas
subjacentes.
ValidationException: Cannot find snapshot older than timestamp
Uma visualização definida com uma cláusula de viagem no tempo faz referência a um snapshot que expirou ou foi removido da tabela subjacente.
Substitua a visualização por CREATE OR REPLACE VIEW usando um carimbo de data/hora ou ID de snapshot mais recente ou ajuste as configurações de retenção de snapshot na tabela do Iceberg.
409 Conflict: Namespace is not empty ao descartar um namespace
Não é possível descartar um namespace que ainda contém visualizações. Liste e remova as visualizações restantes e, em seguida, remova o namespace:
SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;
400 Bad Request com FAILED_PRECONDITION em operações de visualização
As visualizações do Iceberg são compatíveis apenas com catálogos de vários buckets e catálogos de bucket único. O catálogo rejeita operações de visualização em catálogos do BigQuery ou federados. Crie a visualização em um tipo de catálogo compatível.
400 Bad Request: View location is immutable
Não é possível alterar o local de armazenamento de uma visualização depois de criá-la. Remova a atualização do local da sua solicitação.
No Trino 481 e versões anteriores, CREATE OR REPLACE VIEW envia uma atualização do local que aciona esse erro. Faça upgrade para o Trino 482 ou mais recente ou execute DROP VIEW
seguido por CREATE VIEW para atualizar a definição da visualização. Para mais informações,
consulte Suporte do Trino.
A seguir
- Leia a Visão geral das visualizações do Apache Iceberg.
- Saiba como criar uma visualização.