Créer un espace de noms

Le catalogue d'environnements d'exécution Lakehouse vous permet de créer des espaces de noms dans des points de terminaison de catalogue Lakehouse sans frontières pour regrouper et organiser les tables associées.

Lorsque vous créez un espace de noms, vous pouvez l'associer à un bucket Cloud Storage ou un chemin d'accès personnalisé, ou hériter de l'emplacement de stockage par défaut du catalogue.

Avant de commencer

  1. Consultez À propos du catalogue d'environnements d'exécution Lakehouse pour comprendre le fonctionnement du catalogue d'environnements d'exécution Lakehouse et les limites du service.
  2. 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, 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.

    Enable the API

Rôles requis

Pour obtenir les autorisations nécessaires pour créer un espace de noms, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un espace de noms

Créez un espace de noms dans un catalogue.

Remarques

Lorsque vous créez un espace de noms, vous pouvez éventuellement spécifier un bucket Cloud Storage ou un chemin d'accès à associer à l'espace de noms :

  • Catalogue à plusieurs buckets (recommandé) : vous pouvez définir n'importe quel emplacement personnalisé, à condition qu'il se trouve dans un emplacement autorisé par le catalogue (default_location ou restricted_locations). Si vous ne spécifiez pas d'emplacement, l'espace de noms est créé dans l'emplacement par défaut du catalogue (par exemple, gs://{default_location}/{namespace_name}).
  • Catalogue à bucket unique : l'emplacement de l'espace de noms est automatiquement hérité du bucket unique du catalogue.

Console

  1. Dans la console Google Cloud , accédez à la page Lakehouse.

    Accéder à Lakehouse

  2. Sélectionnez un catalogue existant ou créez-en un si vous n'en avez pas.

  3. Sur la page Détails du catalogue qui s'affiche, cliquez sur Créer un espace de noms.

  4. Dans la section Détails de l'espace de noms, configurez les paramètres suivants :

    • Dans le champ Nom de l'espace de noms, saisissez un nom unique pour votre espace de noms.
    • Facultatif : Dans le champ Emplacement, saisissez ou recherchez un bucket Cloud Storage ou un chemin d'accès à associer à votre espace de noms. Par défaut, ce champ est renseigné avec un chemin d'accès situé sous l'emplacement par défaut du catalogue. Pour un catalogue à plusieurs buckets, l'emplacement doit se trouver sous un emplacement d'entrepôt autorisé par le catalogue. Pour un catalogue à bucket unique, l'emplacement est automatiquement hérité du bucket du catalogue.
    • Facultatif : Dans le champ Propriétaire, saisissez ou mettez à jour le propriétaire de l'espace de noms. Par défaut, ce champ est renseigné avec votre nom d'utilisateur.
  5. Facultatif : Pour ajouter des propriétés de métadonnées personnalisées à l'espace de noms, cliquez sur Ajouter une propriété dans la section Propriétés. Dans les champs Clé et Valeur, saisissez une clé et une valeur.

  6. Cliquez sur Créer. Votre espace de noms est créé et apparaît dans le tableau Espaces de noms de la page Détails du catalogue.

gcloud

Créer un espace de noms dans un catalogue à plusieurs buckets (recommandé)

Pour créer un espace de noms dans un catalogue à plusieurs buckets (où vous pouvez éventuellement spécifier un emplacement personnalisé), exécutez la commande gcloud biglake iceberg namespaces create avec l'option --properties :

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

Remplacez les éléments suivants :

  • NAMESPACE_NAME : nom de votre espace de noms.
  • PROJECT_ID : ID de votre projet Google Cloud .
  • CATALOG_ID : ID de votre catalogue.
  • LOCATION : (facultatif) bucket ou chemin d'accès Cloud Storage personnalisé à associer à l'espace de noms (par exemple, gs://my-bucket/my-path).

Créer un espace de noms dans un catalogue à bucket unique

Pour créer un espace de noms dans un catalogue à bucket unique, omettez l'option --properties. L'emplacement de l'espace de noms est automatiquement hérité du bucket unique du catalogue.

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

REST

Pour créer un espace de noms à l'aide de l'API REST, envoyez une requête POST au point de terminaison CreateIcebergNamespace :

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

Le corps de la requête doit contenir une charge utile JSON Iceberg CreateNamespaceRequest qui définit l'identifiant et les propriétés de l'espace de noms :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • CATALOG_ID : ID de votre catalogue.
  • NAMESPACE_NAME : nom de votre espace de noms.
  • LOCATION : (facultatif) bucket ou chemin d'accès Cloud Storage personnalisé à associer à l'espace de noms (par exemple, gs://my-bucket/my-path).

Étapes suivantes