在目錄 (例如 Apache Iceberg REST 目錄或 Apache Hive 目錄) 中建立命名空間,有助於在 Lakehouse 執行階段目錄中整理資料表。
事前準備
-
啟用 BigLake API。
啟用 API 時所需的角色
如要啟用 API,您需要具備服務使用情形管理員 IAM 角色 (
roles/serviceusage.serviceUsageAdmin),其中包含serviceusage.services.enable權限。瞭解如何授予角色。
必要的角色
如要取得建立命名空間所需的權限,請要求管理員在專案中授予您下列 IAM 角色:
-
全部:
- BigLake 管理員 (
roles/biglake.admin) - 儲存空間管理員 (
roles/storage.admin)
- BigLake 管理員 (
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
建立命名空間
在目錄中建立命名空間。
控制台
在 Google Cloud 控制台中開啟「Lakehouse」Lakehouse頁面。
選取現有目錄,或建立目錄 (如果沒有)。
在選單列中,按一下「+ 建立命名空間」。
在「命名空間名稱」欄位中,輸入命名空間的專屬名稱。
在「Location」(位置) 部分,選取要與命名空間建立關聯的 Cloud Storage 值區。
點選「建立」。
命名空間建立完成後,會顯示在目錄詳細資料清單中。
REST
如要使用 REST API 建立命名空間,請對 CreateIcebergNamespace 端點發出 POST 要求:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces
要求主體必須包含有效的 Iceberg CreateNamespaceRequest JSON 酬載,定義命名空間 ID 和屬性。
更改下列內容:
PROJECT_ID:您的 Google Cloud 專案 ID。CATALOG_ID:Lakehouse 執行階段目錄的 ID。