Method: iceberg.v1.restcatalog.extensions.projects.catalogs.create

Iceberg REST 카탈로그를 만듭니다. Google Cloud Storage 버킷 카탈로그 ID는 카탈로그가 생성된 버킷입니다 (예: gs://my-catalog의 경우 my-catalog).

버킷이 없거나 호출자에게 버킷 메타데이터 권한이 없으면 카탈로그가 생성되지 않습니다.

HTTP 요청


POST https://biglake.googleapis.com/iceberg/v1/restcatalog/extensions/{parent=projects/*}/catalogs

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 카탈로그가 생성될 상위 리소스입니다. 형식: projects/{projectId}

쿼리 파라미터

파라미터
iceberg-catalog-id

string

필수 항목입니다. 카탈로그의 이름입니다.
primary_location

string

(선택사항) 카탈로그 메타데이터가 저장될 기본 위치입니다.

Google Cloud Storage 버킷 카탈로그 및 BigLake 카탈로그의 경우 이를 지정하지 않으면 리전이 버킷의 리전 (BigLake 카탈로그의 경우 defaultLocation 버킷)에서 추론됩니다. 지정된 경우 리전은 관할권 (BigLake 카탈로그의 경우 defaultLocation 버킷의 리전 및 restrictedLocations 버킷의 리전 근처)에 있어야 합니다.

연합 카탈로그의 경우 이를 지정해야 하며 Lakehouse 지원 위치 (https://docs.cloud.google.com/lakehouse/docs/locations))여야 합니다. 최고의 성능과 비용을 위해 원격 카탈로그의 위치와 가까워야 합니다.

요청 본문

요청 본문에 IcebergCatalog의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 IcebergCatalog의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.