Lakehouse 런타임 카탈로그를 사용하면 경계 없는 Lakehouse 카탈로그 엔드포인트에서 네임스페이스를 만들어 관련 테이블을 그룹화하고 구성할 수 있습니다.
네임스페이스를 만들 때 원하는 경우 커스텀 Cloud Storage 버킷 또는 경로와 연결하거나 카탈로그의 기본 스토리지 위치를 상속할 수 있습니다.
시작하기 전에
- 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.
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 관리자(
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
네임스페이스 만들기
카탈로그 내에 네임스페이스를 만듭니다.
고려사항
네임스페이스를 만들 때 원하는 경우 네임스페이스와 연결할 Cloud Storage 버킷 또는 경로를 지정할 수 있습니다.
- 여러 버킷 카탈로그(권장): 카탈로그에서 허용하는 위치(
default_location또는restricted_locations)에 있는 한 커스텀 위치를 설정할 수 있습니다. 위치를 지정하지 않으면 카탈로그의 기본 위치(예:gs://{default_location}/{namespace_name})에 네임스페이스가 생성됩니다. 단일 버킷 카탈로그: 네임스페이스 위치는 카탈로그의 단일 버킷에서 자동으로 상속됩니다.
콘솔
Google Cloud 콘솔에서 Lakehouse 페이지로 이동합니다.
기존 카탈로그를 선택하거나 카탈로그가 없는 경우 카탈로그를 만듭니다.
카탈로그 세부정보 페이지가 열리면 네임스페이스 만들기를 클릭합니다.
네임스페이스 세부정보 섹션에서 다음 설정을 구성합니다.
- 네임스페이스 이름 필드에 네임스페이스의 고유한 이름을 입력합니다.
- 선택사항: 위치 필드에 네임스페이스와 연결할 Cloud Storage 버킷 또는 경로를 입력하거나 찾습니다. 기본적으로 이 필드는 카탈로그의 기본 위치 아래에 있는 경로로 채워집니다. 다중 버킷 카탈로그의 경우 위치는 카탈로그에서 허용하는 웨어하우스 위치 아래에 있어야 합니다. 단일 버킷 카탈로그의 경우 위치는 카탈로그의 버킷에서 자동으로 상속됩니다.
- 선택사항: 소유자 필드에 네임스페이스 소유자를 입력하거나 업데이트합니다. 기본적으로 이 필드는 사용자 이름으로 채워집니다.
선택사항: 네임스페이스에 커스텀 메타데이터 속성을 추가하려면 속성 섹션에서 속성 추가를 클릭합니다. 키 및 값 필드에 키와 값을 입력합니다.
만들기를 클릭합니다. 네임스페이스가 생성되고 카탈로그 세부정보 페이지의 네임스페이스 테이블에 표시됩니다.
gcloud
여러 버킷 카탈로그에 네임스페이스 만들기(권장)
여러 버킷 카탈로그에 네임스페이스를 만들려면(선택적으로 커스텀 위치를 지정할 수 있음) --properties 플래그와 함께 gcloud biglake iceberg namespaces create 명령어를 실행합니다.
gcloud biglake iceberg namespaces create NAMESPACE_NAME \ --project="PROJECT_ID" \ --catalog="CATALOG_ID" \ [--properties="location=LOCATION"]
다음을 바꿉니다.
NAMESPACE_NAME: 네임스페이스 이름입니다.PROJECT_ID: Google Cloud 프로젝트 ID입니다.CATALOG_ID: 카탈로그의 ID입니다.LOCATION: (선택사항) 네임스페이스와 연결할 커스텀 Cloud Storage 버킷 또는 경로입니다(예:gs://my-bucket/my-path).
단일 버킷 카탈로그에 네임스페이스 만들기
단일 버킷 카탈로그에 네임스페이스를 만들려면 --properties 플래그를 생략합니다.
네임스페이스 위치는 카탈로그의 단일 버킷에서 자동으로 상속됩니다.
gcloud biglake iceberg namespaces create NAMESPACE_NAME \ --project="PROJECT_ID" \ --catalog="CATALOG_ID"
REST
REST API를 사용하여 네임스페이스를 만들려면 POST 요청을 CreateIcebergNamespace 엔드포인트에 보냅니다.
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces
요청 본문에는 네임스페이스 식별자와 속성을 정의하는 Iceberg CreateNamespaceRequest JSON 페이로드가 포함되어야 합니다.
{
"namespace": [
"NAMESPACE_NAME"
],
"properties": {
"location": "LOCATION"
}
}
다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 ID입니다.CATALOG_ID: 카탈로그의 ID입니다.NAMESPACE_NAME: 네임스페이스 이름입니다.LOCATION: (선택사항) 네임스페이스와 연결할 커스텀 Cloud Storage 버킷 또는 경로입니다(예:gs://my-bucket/my-path).
다음 단계
- 네임스페이스 ACL 관리 방법 알아보기