Lakehouse 런타임 카탈로그를 사용하면 경계 없는 Lakehouse에서 카탈로그 엔드포인트의 구성과 메타데이터를 검사할 수 있습니다. Apache Iceberg REST 카탈로그 엔드포인트의 경우 클라이언트 연결에 필요한 REST 카탈로그 URI, 인증 방법, 연결된 서비스 계정을 검색할 수 있습니다. 카탈로그 엔드포인트에 대한 자세한 내용은 카탈로그 유형 및 엔드포인트 구성을 참조하세요.
시작하기 전에
- Lakehouse 런타임 카탈로그 정보를 읽고 Lakehouse 런타임 카탈로그의 작동 방식과 서비스 제한사항을 이해합니다.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles. - 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
Verify that billing is enabled for your Google Cloud project.
Enable the BigLake API, if it is not already enabled.
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.
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
Verify that billing is enabled for your Google Cloud project.
Enable the BigLake API, if it is not already enabled.
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.
필요한 역할
카탈로그 엔드포인트 세부정보를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
전체:
- BigLake 관리자(
roles/biglake.admin) - 스토리지 관리자(
roles/storage.admin)
- BigLake 관리자(
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
카탈로그 엔드포인트 세부정보 가져오기
카탈로그 엔드포인트 구성 및 속성을 검사합니다.
콘솔
Google Cloud 콘솔에서 Lakehouse 페이지를 엽니다.
카탈로그 이름을 클릭합니다.
카탈로그 세부정보 페이지에서 카탈로그 ID, 생성 타임스탬프, REST 카탈로그 URI, 인증 방법, 서비스 계정과 같은 카탈로그 정보를 살펴봅니다.
페더레이션 카탈로그의 경우 구성된 경우 카탈로그 세부정보 페이지에 다음 속성도 표시됩니다.
- ID 모드: Databricks Unity Catalog 연결의 경우
Service identity또는User identity federation를 표시합니다. - 서비스 디렉터리 이름: AWS Glue, Snowflake Horizon Catalog, Databricks Unity Catalog 연결에서 비공개 쿼리 전송을 위해 구성된 서비스 디렉터리 서비스 리소스 이름을 표시합니다.
- 메타데이터 서비스 디렉터리 이름: AWS Glue, Snowflake Horizon Catalog, Databricks Unity Catalog 연결에서 비공개 백그라운드 메타데이터 새로고침을 위해 구성된 서비스 디렉터리 서비스 리소스 이름을 표시합니다.
- ID 모드: Databricks Unity Catalog 연결의 경우
gcloud
Google Cloud CLI를 사용하여 카탈로그 엔드포인트를 설명하려면 gcloud biglake iceberg catalogs describe 명령어를 실행합니다.
gcloud biglake iceberg catalogs describe CATALOG_ID \ --project="PROJECT_ID"
다음을 바꿉니다.
CATALOG_ID: 카탈로그의 ID입니다.PROJECT_ID: Google Cloud 프로젝트 ID입니다.
REST
REST API를 사용하여 카탈로그 엔드포인트 세부정보 및 구성을 가져오려면 GetIcebergCatalog 엔드포인트에 GET 요청을 수행합니다.
GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID
응답에는 카탈로그 구성을 설명하는 IcebergCatalog JSON 객체가 포함됩니다.
다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 ID입니다.CATALOG_ID: 카탈로그의 ID입니다.