Iceberg REST 카탈로그 리소스 관리

Lakehouse for Apache Iceberg를 사용하면 Lakehouse 런타임 카탈로그 내에서 Apache Iceberg REST 카탈로그 엔드포인트를 관리할 수 있습니다. console 또는 REST API를 사용하여 이러한 카탈로그를 만들고, 구성하고, 모니터링하여 쿼리 엔진 연결에 필요한 메타데이터 레이어를 설정할 수 있습니다. Google Cloud

시작하기 전에

  1. Lakehouse 런타임 카탈로그 정보를 읽고 Lakehouse 런타임 카탈로그의 작동 방식과 서비스 제한사항을 파악합니다.
    2. 계정에 로그인합니다. Google Cloud 를 처음 사용하는 경우 Google Cloud, 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

필요한 역할

Lakehouse 런타임 카탈로그를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

관리 작업

console 또는 REST API를 사용하여 Apache Iceberg REST 카탈로그 리소스에 대해 다음 관리 작업을 실행할 수 있습니다. Google Cloud

  • 카탈로그 만들기: 기본 Cloud Storage 웨어하우스 위치를 가리키는 Apache Iceberg REST 카탈로그 관리 엔드포인트를 만듭니다 (CreateIcebergCatalog).
  • 카탈로그 업데이트: 기존 Cloud Storage 버킷 카탈로그 (기존 gs:// 카탈로그)를 BigLake 카탈로그 (bl:// 카탈로그)로 업그레이드합니다(UpdateIcebergCatalog).
  • 네임스페이스 만들기: Iceberg REST 카탈로그 내에 네임스페이스를 만들어 관련 테이블을 그룹화합니다 (CreateIcebergNamespace).
  • 사용자 인증 정보 벤더 제공 사용 설정: 기존 카탈로그의 인증 방법을 사용자 인증 정보 벤더 제공 모드로 전환하여 수명이 짧은 스토리지 토큰을 쿼리 엔진에 직접 벤더 제공합니다 (UpdateIcebergCatalog).
  • 카탈로그 세부정보 가져오기: 클라이언트 연결에 필요한 REST 카탈로그 URI를 비롯한 카탈로그의 속성 및 메타데이터를 봅니다 (GetIcebergCatalog).
  • 네임스페이스 ACL 관리: 카탈로그 네임스페이스의 IAM 정책을 보고 업데이트하여 특정 보안 주체의 액세스를 제어합니다 (get-iam-policy, set-iam-policy).
  • 카탈로그 삭제: Lakehouse 런타임 카탈로그에서 카탈로그 메타데이터 관리 엔드포인트를 등록 취소합니다 (DeleteIcebergCatalog).
  • 네임스페이스 삭제: 더 이상 필요하지 않은 경우 Iceberg REST 카탈로그에서 네임스페이스를 삭제합니다 (DeleteIcebergNamespace).
  • 감사 로그 보기: 관리 작업 및 데이터 액세스 활동의 확인 가능한 기록을 위해 Cloud 감사 로그를 검사합니다.

가격 책정

가격 책정에 대한 자세한 내용은 Lakehouse for Apache Iceberg 가격 책정을 참조하세요.

다음 단계