네임스페이스 만들기

카탈로그 (예: Apache Iceberg REST 카탈로그 또는 Apache Hive 카탈로그)에서 네임스페이스를 만들면 Lakehouse 런타임 카탈로그 내에서 테이블을 정리하는 데 도움이 됩니다.

시작하기 전에

1. 레이크하우스 런타임 카탈로그 정보를 읽고 레이크하우스 런타임 카탈로그의 작동 방식과 서비스의 제한사항을 알아보세요.
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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

필요한 역할

네임스페이스를 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

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

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

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

네임스페이스 만들기

카탈로그 내에 네임스페이스를 만듭니다.

고려사항

네임스페이스를 만들 때 네임스페이스와 연결할 Cloud Storage 버킷 또는 경로를 선택적으로 지정할 수 있습니다.

• 다중 버킷 (bl://) (권장): 카탈로그 (default_location 또는 restricted_locations)에서 허용하는 위치 아래에 있는 한 모든 맞춤 위치를 설정할 수 있습니다. 위치를 지정하지 않으면 네임스페이스가 카탈로그의 기본 위치 (예: gs://{default_location}/{namespace_name}) 아래에 생성됩니다.

• 단일 버킷 (gs://): 네임스페이스 위치가 카탈로그의 단일 버킷에서 자동으로 상속됩니다.

콘솔

참고: 멀티 버킷 (bl://) 카탈로그 (권장)는 Google Cloud 콘솔에서 지원되지 않습니다. 이 유형의 카탈로그에서 네임스페이스를 만들려면 gcloud 또는 REST API를 사용하세요.

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

   레이크하우스로 이동

2. 기존 카탈로그를 선택하거나 카탈로그가 없는 경우 카탈로그를 만듭니다.

3. 메뉴 바에서 + 네임스페이스 만들기를 클릭합니다.

4. 네임스페이스 이름에 네임스페이스의 고유한 이름을 입력합니다.

5. 위치에서 네임스페이스와 연결할 Cloud Storage 버킷 또는 경로를 선택적으로 지정합니다. 위치가 창고 버킷과 일치합니다.

6. 만들기를 클릭합니다.

   네임스페이스가 생성되고 카탈로그 세부정보 목록에 표시됩니다.

gcloud

멀티 버킷 (bl://) 카탈로그에서 네임스페이스 만들기 (권장)

다중 버킷 카탈로그에서 네임스페이스를 만들려면 (선택적으로 맞춤 위치를 지정할 수 있음) --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).

단일 버킷 (gs://) 카탈로그에서 네임스페이스 만들기

단일 버킷 카탈로그에서 네임스페이스를 만들려면 --properties 플래그를 생략하세요. 네임스페이스 위치는 카탈로그의 단일 버킷에서 자동으로 상속됩니다.

gcloud biglake iceberg namespaces create NAMESPACE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID"

REST

REST API를 사용하여 네임스페이스를 만들려면 CreateIcebergNamespace 엔드포인트로 POST 요청을 작성합니다.

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 관리 방법을 알아보세요.