Apache Iceberg 뷰를 쿼리하면 Lakehouse 런타임 카탈로그에 저장된 SQL 정의를 실행하여 기본 Iceberg 테이블에서 선별된 제로 카피 결과를 읽을 수 있습니다. Compute Engine은 카탈로그에서 뷰 정의를 로드하고, 참조된 모든 테이블과 중첩된 뷰를 확인한 후 Cloud Storage에서 데이터 파일을 읽습니다.
Spark 및 Trino와 같은 Iceberg 호환 오픈소스 엔진에서만 Iceberg 뷰를 쿼리할 수 있습니다. BigQuery는 Iceberg 뷰 쿼리를 지원하지 않습니다.
시작하기 전에
-
BigLake API가 아직 사용 설정되지 않았으면 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할(roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할(roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기 - Apache Iceberg REST 카탈로그 엔드포인트를 사용하여 Lakehouse 런타임 카탈로그를 설정합니다.
- Iceberg 뷰의 제한사항을 검토합니다.
- 뷰 만들기
필요한 역할
Compute Engine은 클라이언트 측에서 뷰를 평가하므로 뷰와 뷰가 참조하는 모든 테이블 및 중첩된 뷰에 대한 권한이 필요합니다.
뷰를 쿼리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트 및 스토리지 버킷에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
사용자 인증 정보 자동 판매 모드에서 뷰 및 참조 테이블 읽기: BigLake 뷰어(
roles/biglake.viewer) - 프로젝트 -
최종 사용자 인증 정보 모드에서 뷰 및 참조된 테이블을 읽습니다.
- BigLake 뷰어(
roles/biglake.viewer) - 프로젝트 - 스토리지 객체 뷰어(
roles/storage.objectViewer) - Cloud Storage 버킷
- BigLake 뷰어(
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 뷰를 쿼리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
뷰를 쿼리하려면 다음 권한이 필요합니다.
-
뷰 쿼리:
-
뷰 및 중첩된 뷰에 대한
biglake.views.get권한 -
뷰에서 참조하는 각 Iceberg 테이블에 대한
biglake.tables.get권한
-
뷰 및 중첩된 뷰에 대한
-
사용자 인증 정보 자동 판매 모드에서 테이블 데이터 읽기: 뷰가 참조하는 각 Iceberg 테이블에 대한
biglake.tables.getData -
최종 사용자 인증 정보 모드에서 뷰 메타데이터 및 테이블 데이터 읽기: Cloud Storage 버킷에 대한
storage.objects.get
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
전체 보기 권한 목록은 필수 역할 및 권한을 참조하세요.
뷰 쿼리
뷰에서 모든 데이터를 선택합니다.
Spark
SELECT * FROM NAMESPACE_NAME.VIEW_NAME;
다음을 바꿉니다.
NAMESPACE_NAME: 네임스페이스의 이름입니다.VIEW_NAME: 뷰 이름
조인, 집계, CTE, 중첩 뷰가 포함된 뷰를 동일한 방식으로 쿼리할 수 있습니다. 예를 들어 다음 쿼리는 뷰 만들기의 뷰를 사용합니다.
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
시간 이동 및 뷰
TIMESTAMP AS OF 또는 VERSION AS OF과 같은 시간 이동 절을 뷰 식별자에 직접 적용할 수 없습니다. 이전 데이터가 필요한 경우 SQL 정의가 기본 테이블에 시간 이동을 적용하는 뷰를 정의하거나 기본 테이블을 직접 쿼리하는 CTE를 사용합니다. 자세한 내용은 기본 테이블에서 시간 이동을 사용하여 뷰 만들기를 참조하세요.
다음 단계
- 뷰 세부정보를 가져오는 방법 알아보기
- Iceberg 뷰 문제 해결 방법 알아보기