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

Membuat Katalog REST Iceberg. ID katalog Bucket Google Cloud Storage adalah bucket tempat katalog dibuat (misalnya, my-catalog untuk gs://my-catalog).

Jika bucket tidak ada, atau pemanggil tidak memiliki izin metadata bucket, katalog tidak akan dibuat.

Permintaan HTTP


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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Resource induk tempat katalog ini akan dibuat. Format: projects/{projectId}

Parameter kueri

Parameter
iceberg-catalog-id

string

Wajib. Nama katalog.

primary_location

string

Opsional. Lokasi utama tempat metadata katalog akan disimpan.

Untuk katalog bucket Google Cloud Storage dan katalog BigLake, jika tidak ditentukan, region akan disimpulkan dari region bucket (bucket defaultLocation untuk katalog BigLake). Jika ditentukan, region harus berada dalam wilayah hukum (dekat dengan region bucket defaultLocation dan region bucket restrictedLocations untuk katalog BigLake).

Untuk katalog gabungan, lokasi ini harus ditentukan dan merupakan lokasi yang didukung Lakehouse (https://docs.cloud.google.com/lakehouse/docs/locations). Lokasinya harus dekat dengan lokasi katalog jarak jauh untuk mendapatkan performa dan biaya terbaik.

Isi permintaan

Isi permintaan memuat instance IcebergCatalog.

Isi respons

Jika berhasil, isi respons akan memuat instance IcebergCatalog yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.