Apache Iceberg 뷰를 변경하면 Lakehouse 런타임 카탈로그에서 뷰의 ID를 변경하지 않고도 뷰의 스키마와 SQL 정의를 발전시키거나 커스텀 뷰 속성을 설정 및 설정 해제할 수 있습니다.
뷰 이름 바꾸기는 지원되지 않습니다. 뷰 이름을 바꾸려면 새 이름으로 뷰를 만든 다음 원래 뷰를 삭제합니다. 뷰의 스토리지 위치도 생성 후 변경할 수 없으며 다른 위치를 설정하는 업데이트는 400 Bad Request 오류와 함께 실패합니다.
시작하기 전에
-
BigLake API가 아직 사용 설정되지 않았으면 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할(roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할(roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기 - Apache Iceberg REST 카탈로그 엔드포인트를 사용하여 Lakehouse 런타임 카탈로그를 설정합니다.
- Iceberg 뷰의 제한사항을 검토합니다.
- 뷰 만들기
필요한 역할
뷰를 변경하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트 및 스토리지 버킷에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
뷰 변경: BigLake 편집자(
roles/biglake.editor) - 프로젝트 -
최종 사용자 인증 정보 모드에서 뷰 메타데이터 파일 작성: 스토리지 객체 사용자(
roles/storage.objectUser) - Cloud Storage 버킷
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 뷰를 변경하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
뷰를 변경하려면 다음 권한이 필요합니다.
-
뷰 변경:
-
뷰에 대한
biglake.views.update권한 -
새 뷰 정의가 참조하는 각 Iceberg 테이블에 대한
biglake.tables.get권한
-
뷰에 대한
-
최종 사용자 인증 정보 모드에서 뷰 메타데이터 파일 쓰기: Cloud Storage 버킷의
storage.objects.create
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
전체 보기 권한 목록은 필수 역할 및 권한을 참조하세요.
뷰 정의 바꾸기
기존 뷰의 스키마 및 SQL 로직을 바꿉니다. 뷰를 바꾸면 카탈로그가 새 버전의 metadata.json 파일(예: 00001-UUID.metadata.json)을 작성하고, 새 뷰 버전과 스키마를 뷰 메타데이터에 추가하고, 뷰의 view-uuid를 보존합니다.
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
REST API를 사용하여 뷰를 업데이트하려면 UpdateIcebergView 엔드포인트에 대한 POST 요청을 수행합니다.
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
요청 본문에는 적용할 requirements 및 updates가 포함된 유효한 Iceberg CommitViewRequest JSON 페이로드가 포함되어야 합니다. 카탈로그는 낙관적 동시 실행 요구사항을 검증하고 업데이트를 새 metadata.json 파일에 커밋합니다.
다음을 바꿉니다.
PROJECT_ID: Google Cloud프로젝트 IDCATALOG_ID: 카탈로그의 ID입니다.NAMESPACE_NAME: 카탈로그 네임스페이스의 이름입니다.VIEW_NAME: 뷰 이름
뷰 속성 설정 및 설정 해제
정의를 변경하지 않고 뷰에서 맞춤 속성을 설정하거나 삭제합니다.
Spark
속성을 설정합니다.
ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');
속성 설정 해제:
ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');
카탈로그에서 write.metadata.compression-codec와 같은 속성을 처리하는 방법에 대한 자세한 내용은 속성 보기를 참조하세요.
REST
set-properties 또는 remove-properties 업데이트를 사용하여 CommitViewRequest를 UpdateIcebergView 엔드포인트로 전송합니다. 엔드포인트 경로는 뷰 정의 바꾸기를 참조하세요.
다음 단계
- 뷰 세부정보를 가져오는 방법 알아보기
- 뷰 삭제 방법 알아보기