레이크하우스 런타임 카탈로그에서 Apache Iceberg 뷰를 만들거나, 쿼리하거나, 변경하거나, 삭제할 때 테이블과의 이름 충돌, 액세스 거부, 뷰의 시간 이동, 만료된 스냅샷, 지원되지 않는 카탈로그 유형, 변경할 수 없는 뷰 위치와 같은 오류가 발생할 수 있습니다. 이 문서는 이러한 일반적인 오류의 원인을 파악하고 해결하는 데 도움이 됩니다. 일반적인 카탈로그 문제는 문제 해결을 참조하세요.
뷰 또는 테이블을 만들거나 바꿀 때 409 Conflict 또는 AlreadyExistsException
테이블과 뷰는 카탈로그 네임스페이스 내에서 동일한 식별자 네임스페이스를 공유하며 카탈로그는 교차 유형 덮어쓰기를 차단합니다. 기존 테이블과 동일한 이름의 뷰 또는 기존 뷰와 동일한 이름의 테이블을 만들 수 없습니다.
이름 충돌을 찾으려면 네임스페이스의 테이블과 뷰를 모두 나열합니다.
SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;
다른 이름을 선택하거나 충돌하는 객체를 먼저 삭제하세요.
뷰 작업에 대한 403 Forbidden 또는 AccessDeniedException
Compute Engine은 클라이언트 측에서 뷰를 평가하므로 뷰를 쿼리하려면 뷰와 뷰가 참조하는 모든 테이블에 대한 권한이 필요합니다. 다음 사항을 확인하세요.
- 뷰 DDL의 경우 호출자에게 BigLake 편집자(
roles/biglake.editor) 또는 BigLake 관리자(roles/biglake.admin)가 있습니다. SELECT쿼리의 경우 호출자에게 BigLake 뷰어(roles/biglake.viewer)가 있으며, 이는 뷰에 대한biglake.views.get및 참조된 테이블에 대한biglake.tables.get및biglake.tables.getData를 부여합니다.- 최종 사용자 인증 정보 모드에서 호출자는 뷰 DDL의 경우 Cloud Storage 버킷에 대한 스토리지 객체 사용자(
roles/storage.objectUser) 권한을, 읽기 전용 쿼리의 경우 스토리지 객체 뷰어(roles/storage.objectViewer) 권한을 가집니다. - 사용자 인증 정보 자동 판매 모드에서 카탈로그의 서비스 계정에는 Cloud Storage 버킷에 대한 스토리지 객체 사용자(
roles/storage.objectUser)가 있고 Spark는spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials로 구성됩니다.
자세한 내용은 필수 역할 및 권한을 참조하세요.
UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW
쿼리가 TIMESTAMP AS OF 또는 VERSION AS OF를 뷰 식별자에 직접 적용하면 Spark는 AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW]
Cannot time travel on view를 반환합니다.
쿼리에서 시간 이동 절을 삭제합니다. 이전 데이터가 필요한 경우 SQL 정의가 기본 테이블에 TIMESTAMP AS OF를 적용하는 뷰를 정의하거나 기본 테이블을 직접 쿼리하는 CTE를 사용합니다. 자세한 내용은 기본 테이블에서 시간 이동을 사용하여 뷰 만들기를 참조하세요.
ValidationException: Cannot find snapshot older than timestamp
시간 이동 절로 정의된 뷰가 만료되었거나 기본 테이블에서 삭제된 스냅샷을 참조합니다.
최신 타임스탬프 또는 스냅샷 ID를 사용하여 뷰를 CREATE OR REPLACE VIEW로 바꾸거나 기본 Iceberg 테이블에서 스냅샷 보관 설정을 조정합니다.
네임스페이스를 삭제할 때 409 Conflict: Namespace is not empty
뷰가 포함된 네임스페이스는 삭제할 수 없습니다. 남은 뷰를 나열하고 삭제한 후 네임스페이스를 삭제합니다.
SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;
보기 작업에 대한 FAILED_PRECONDITION가 있는 400 Bad Request
Iceberg 뷰는 멀티 버킷 카탈로그 및 단일 버킷 카탈로그에서만 지원됩니다. 카탈로그는 BigQuery 카탈로그 또는 페더레이션 카탈로그에 대한 뷰 작업을 거부합니다. 지원되는 카탈로그 유형으로 뷰를 만듭니다.
400 Bad Request: View location is immutable
뷰를 만든 후에는 뷰의 스토리지 위치를 변경할 수 없습니다. 요청에서 위치 업데이트를 삭제합니다.
Trino 481 이하에서는 CREATE OR REPLACE VIEW가 이 오류를 트리거하는 위치 업데이트를 전송합니다. Trino 482 이상으로 업그레이드하거나 DROP VIEW를 실행한 후 CREATE VIEW를 실행하여 뷰 정의를 업데이트합니다. 자세한 내용은 Trino 지원을 참조하세요.
다음 단계
- Apache Iceberg 뷰 개요를 읽어보세요.
- 뷰를 만드는 방법 알아보기