Spark 또는 Apache Iceberg REST 카탈로그 엔드포인트를 사용하여 Lakehouse 런타임 카탈로그에 등록된 Apache Iceberg 뷰의 스키마, 열 주석, 속성, SQL 정의를 검사할 수 있습니다.
시작하기 전에
-
BigLake API가 아직 사용 설정되지 않았으면 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할(roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할(roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기 - Apache Iceberg REST 카탈로그 엔드포인트를 사용하여 Lakehouse 런타임 카탈로그를 설정합니다.
- Iceberg 뷰의 제한사항을 검토합니다.
- 뷰 만들기
필요한 역할
뷰 세부정보를 가져오는 데 필요한 권한을 얻으려면 관리자에게 프로젝트 및 스토리지 버킷에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
뷰 세부정보 가져오기: BigLake 뷰어(
roles/biglake.viewer) - 프로젝트 -
최종 사용자 인증 정보 모드에서 뷰 메타데이터 파일 읽기: 스토리지 객체 뷰어(
roles/storage.objectViewer) - Cloud Storage 버킷
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 뷰 세부정보를 가져오는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
뷰 세부정보를 가져오려면 다음 권한이 필요합니다.
-
뷰 세부정보 가져오기: 뷰에 대한
biglake.views.get권한 -
최종 사용자 인증 정보 모드에서 뷰 메타데이터 파일 읽기: Cloud Storage 버킷의
storage.objects.get
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
전체 보기 권한 목록은 필수 역할 및 권한을 참조하세요.
뷰 세부정보 가져오기
뷰를 검사합니다.
Spark
뷰 스키마, 열 주석, 뷰 속성을 표시합니다.
DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;
뷰를 정의하는 SQL 문을 표시합니다.
SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;
뷰 속성만 표시합니다.
SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;
다음을 바꿉니다.
NAMESPACE_NAME: 네임스페이스의 이름입니다.VIEW_NAME: 뷰 이름
REST
REST API를 사용하여 뷰의 현재 메타데이터를 로드하려면 GetIcebergView 엔드포인트에 GET 요청을 수행합니다.
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
응답에는 뷰의 metadata-location 및 metadata가 포함됩니다.
메타데이터를 로드하지 않고 뷰가 있는지 확인하려면 동일한 경로에 HEAD 요청을 보냅니다. CheckIcebergViewExists 엔드포인트는 뷰가 있으면 204 No Content를 반환하고 없으면 404 Not Found를 반환합니다.
다음을 바꿉니다.
PROJECT_ID: Google Cloud프로젝트 IDCATALOG_ID: 카탈로그의 ID입니다.NAMESPACE_NAME: 카탈로그 네임스페이스의 이름입니다.VIEW_NAME: 뷰 이름