Mit dem Lakehouse-Laufzeitkatalog können Sie Namespaces in grenzenlosen Lakehouse-Katalogendpunkten erstellen, um verwandte Tabellen zu gruppieren und zu organisieren.
Wenn Sie einen Namespace erstellen, können Sie ihn optional mit einem benutzerdefinierten Cloud Storage-Bucket oder -Pfad verknüpfen oder den Standardspeicherort des Katalogs übernehmen.
Hinweis
- Weitere Informationen zur Funktionsweise des Lakehouse-Laufzeitkatalogs und zu den Einschränkungen des Dienstes finden Sie unter Informationen zum Lakehouse-Laufzeitkatalog.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
Verify that billing is enabled for your Google Cloud project.
Enable the BigLake API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the serviceusage.services.enable permission. If you
created the project, then you likely already have this permission through the
Owner role (roles/owner). Otherwise, you can get this permission through the
Service Usage Admin role (roles/serviceusage.serviceUsageAdmin).
Learn how to grant roles.
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:
-
Alle:
- BigLake-Administrator (
roles/biglake.admin) - Storage-Administrator (
roles/storage.admin)
- BigLake-Administrator (
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:
- Katalog mit mehreren Buckets (empfohlen): Sie können einen beliebigen benutzerdefinierten Speicherort festlegen, solange er sich an einem vom Katalog zugelassenen Speicherort (
default_locationoderrestricted_locations) befindet. Wenn Sie keinen Speicherort angeben, wird der Namespace am Standardspeicherort des Katalogs erstellt (z. B.gs://{default_location}/{namespace_name}). Katalog mit einem Bucket: Der Namespace-Standort wird automatisch vom einzelnen Bucket des Katalogs übernommen.
Console
Rufen Sie in der Google Cloud Console die Seite Lakehouse auf.
Wählen Sie einen vorhandenen Katalog aus oder erstellen Sie einen Katalog, falls Sie noch keinen haben.
Klicken Sie auf der Seite Katalogdetails, die geöffnet wird, auf Namespace erstellen.
Konfigurieren Sie im Abschnitt Namespace-Details die folgenden Einstellungen:
- Geben Sie im Feld Namespace-Name einen eindeutigen Namen für den Namespace ein.
- Optional: Geben Sie im Feld Standort einen Cloud Storage-Bucket oder -Pfad ein, der mit Ihrem Namespace verknüpft werden soll, oder suchen Sie danach. Standardmäßig wird dieses Feld mit einem Pfad unter dem Standardspeicherort des Katalogs ausgefüllt. Bei einem Katalog mit mehreren Buckets muss sich der Speicherort unter einem vom Katalog zugelassenen Warehouse-Speicherort befinden. Bei einem Katalog mit einem einzelnen Bucket wird der Standort automatisch vom Bucket des Katalogs übernommen.
- Optional: Geben Sie im Feld Inhaber den Namespace-Inhaber ein oder aktualisieren Sie ihn. Standardmäßig wird dieses Feld mit Ihrem Nutzernamen ausgefüllt.
Optional: Wenn Sie dem Namespace benutzerdefinierte Metadatenattribute hinzufügen möchten, klicken Sie im Abschnitt Attribute auf Attribut hinzufügen. Geben Sie in die Felder Schlüssel und Wert einen Schlüssel und einen Wert ein.
Klicken Sie auf Erstellen. Der Namespace wird erstellt und in der Tabelle Namespaces auf der Seite Katalogdetails angezeigt.
gcloud
Namespace in einem Katalog mit mehreren Buckets erstellen (empfohlen)
Wenn Sie einen Namespace in einem Katalog mit mehreren Buckets erstellen möchten (in dem Sie optional einen benutzerdefinierten Speicherort angeben können), führen Sie den Befehl gcloud biglake iceberg namespaces create 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 mit dem Namespace verknüpft werden soll (z. B.gs://my-bucket/my-path).
Namespace in einem Katalog mit einem einzelnen Bucket erstellen
Wenn Sie einen Namespace in einem Katalog mit einem einzelnen 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 Iceberg-CreateNamespaceRequest-JSON-Nutzlast enthalten, die die Namespace-ID und die Attribute definiert:
{
"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 mit dem Namespace verknüpft werden soll (z. B.gs://my-bucket/my-path).