카탈로그 세부정보 가져오기

구성 속성을 가져오면 Lakehouse for Apache Iceberg 의 메타데이터가 노출됩니다.

Lakehouse 런타임 카탈로그 내에서 기존 카탈로그 (예: Apache Iceberg REST 카탈로그 또는 Apache Hive 카탈로그)를 검사하면 세부정보가 표시됩니다. Apache Iceberg REST 카탈로그의 경우 클라이언트 연결에 필요한 REST 카탈로그 URI, 인증 방법, 연결된 서비스 계정이 포함됩니다.

시작하기 전에

1. Lakehouse 런타임 카탈로그 정보를 읽고 Lakehouse 런타임 카탈로그의 작동 방식과 서비스 제한사항을 파악합니다.
계정에 로그인합니다. 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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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

필요한 역할

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

• 모두:
  • BigLake 관리자 (roles/biglake.admin)
  • 스토리지 관리자 (roles/storage.admin)

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

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

카탈로그 세부정보 가져오기

카탈로그 구성 및 속성을 검사합니다.

콘솔

1. 콘솔에서 Lakehouse 페이지를 엽니다. Google Cloud

   Lakehouse로 이동

2. 카탈로그 이름을 클릭합니다.

3. 카탈로그 세부정보 페이지에서 카탈로그 ID, 생성 타임스탬프, REST 카탈로그 URI, 인증 방법, 서비스 계정과 같은 카탈로그 정보를 살펴봅니다.

gcloud

gcloud를 사용하여 카탈로그를 설명하려면 gcloud biglake iceberg catalogs describe 명령어를 실행합니다.

gcloud biglake iceberg catalogs describe CATALOG_ID \
    --project="PROJECT_ID"

다음을 바꿉니다.

• CATALOG_ID: 카탈로그의 ID입니다.
• PROJECT_ID: 프로젝트 ID입니다. Google Cloud

REST

REST API를 사용하여 카탈로그 세부정보 및 구성을 가져오려면 GET 요청을 GetIcebergCatalog 엔드포인트에 합니다.

GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID

응답에는 카탈로그 구성을 설명하는 IcebergCatalog JSON 객체가 포함됩니다.

다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다. Google Cloud
• CATALOG_ID: 카탈로그의 ID입니다.