Namespace erstellen

Wenn Sie einen Namespace in einem Katalog (z. B. einem Apache Iceberg REST-Katalog oder einem Apache Hive-Katalog) erstellen, können Sie Ihre Tabellen im Lakehouse-Laufzeitkatalog organisieren.

Hinweis

  1. Lesen Sie Informationen zum Lakehouse-Laufzeitkatalog, um zu erfahren, wie der Lakehouse-Laufzeitkatalog funktioniert und welche Einschränkungen für den Dienst gelten.
    2. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

    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.

    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.

    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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Erstellen eines Namespace haben:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Namespace erstellen

Namespace in einem Katalog erstellen

Hinweise

Wenn Sie einen Namespace erstellen, können Sie optional einen Cloud Storage-Bucket oder -Pfad angeben, der mit dem Namespace verknüpft werden soll:

  • Mehrere Buckets (bl://) (empfohlen): Sie können einen beliebigen benutzerdefinierten Speicherort festlegen, sofern er sich an einem vom Katalog zugelassenen Speicherort (default_location oder restricted_locations) befindet. Wenn Sie keinen Speicherort angeben, wird der Namespace am standardmäßigen Standort des Katalogs erstellt (z. B. gs://{default_location}/{namespace_name}).

  • Einzelner Bucket (gs://): Der Namespace-Speicherort wird automatisch vom einzelnen Bucket des Katalogs übernommen.

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Lakehouse.

    Lakehouse aufrufen

  2. Wählen Sie einen vorhandenen Katalog aus oder erstellen Sie einen, falls Sie noch keinen haben.

  3. Klicken Sie in der Menüleiste auf + Namespace erstellen.

  4. Geben Sie unter Namespace-Name einen eindeutigen Namen für den Namespace ein.

  5. Geben Sie für Speicherort optional einen Cloud Storage-Bucket oder -Pfad an, der mit Ihrem Namespace verknüpft werden soll. Der Standort entspricht dem Warehouse-Bucket.

  6. Klicken Sie auf Erstellen.

    Ihr Namespace wird erstellt und in der Liste der Katalogdetails angezeigt.

gcloud

Namespace in einem Katalog mit mehreren Buckets (bl://) erstellen (empfohlen)

Wenn Sie einen Namespace in einem Katalog mit mehreren Buckets erstellen möchten (wobei Sie optional einen benutzerdefinierten Speicherort angeben können), führen Sie den gcloud biglake iceberg namespaces create-Befehl mit dem Flag --properties aus:

gcloud biglake iceberg namespaces create NAMESPACE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    [--properties="location=LOCATION"]

Ersetzen Sie Folgendes:

  • NAMESPACE_NAME: Ein Name für Ihren Namespace.
  • PROJECT_ID: Projekt-ID in Google Cloud .
  • CATALOG_ID: Die ID Ihres Katalogs.
  • LOCATION: (Optional) Ein benutzerdefinierter Cloud Storage-Bucket oder -Pfad, der dem Namespace zugeordnet werden soll (z. B. gs://my-bucket/my-path).

Namespace in einem Katalog mit einem Bucket (gs://) erstellen

Wenn Sie einen Namespace in einem Katalog mit einem Bucket erstellen möchten, lassen Sie das Flag --properties weg. Der Namespace-Standort wird automatisch vom einzelnen Bucket des Katalogs übernommen.

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

REST

Wenn Sie einen Namespace mit der REST API erstellen möchten, senden Sie eine POST-Anfrage an den Endpunkt CreateIcebergNamespace:

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces

Der Anfragetext muss eine gültige Iceberg-CreateNamespaceRequest-JSON-Nutzlast enthalten, in der die Namespace-ID und die Eigenschaften definiert sind:

{
  "namespace": [
    "NAMESPACE_NAME"
  ],
  "properties": {
    "location": "LOCATION"
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • CATALOG_ID: Die ID Ihres Katalogs.
  • NAMESPACE_NAME: Ein Name für Ihren Namespace.
  • LOCATION: (Optional) Ein benutzerdefinierter Cloud Storage-Bucket oder -Pfad, der dem Namespace zugeordnet werden soll (z. B. gs://my-bucket/my-path).

Nächste Schritte