Créer et gérer des vues matérialisées continues

Ce document explique comment créer et effectuer des opérations sur une vue matérialisée continue dans Bigtable. Avant de lire ce document, consultez la présentation des vues matérialisées continues.

Vous pouvez créer une vue matérialisée continue à l'aide de Google Cloud CLI, de l'éditeur de requêtes Bigtable Studio dans la console Google Cloud ou des bibliothèques clientes Bigtable pour Java et Go.

Avant de commencer

Si vous prévoyez d'utiliser la gcloud CLI, procédez comme suit.

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

Rôles requis

Pour obtenir les autorisations nécessaires pour créer et gérer des vues matérialisées continues, demandez à votre administrateur de vous accorder le rôle Administrateur Bigtable (roles/bigtable.admin) sur l'instance. Sinon, demandez les autorisations suivantes au niveau de l'instance, en fonction de l'opération que vous souhaitez effectuer :

  • Créer : bigtable.materializedViews.create
  • Mise à jour : bigtable.materializedViews.update
  • Supprimer : bigtable.materializedViews.delete
  • Liste : bigtable.materializedViews.list

Pour créer une vue matérialisée continue, vous devez également disposer au minimum de l'autorisation bigtable.tables.readRows sur la table source.

Pour afficher tous les rôles et autorisations disponibles, consultez Contrôle des accès à Bigtable avec IAM.

Créer une vue matérialisée continue

Avant de créer une vue matérialisée continue, procédez comme suit :

  • Facultatif : Par mesure de précaution, activez l'autoscaling pour les clusters de votre instance. Vous vous assurerez ainsi qu'ils peuvent évoluer si nécessaire pendant que Bigtable traite et synchronise la vue matérialisée continue, et pour gérer toute utilisation de l'espace de stockage supplémentaire.
  • Identifiez une table Bigtable que vous êtes autorisé à lire et qui servira de source pour la vue matérialisée continue.
  • Préparez la requête SQL qui définit votre vue matérialisée continue. Pour connaître les exigences concernant les requêtes, consultez Requêtes de vues matérialisées continues.

Une fois que vous avez créé une vue matérialisée continue, il peut s'écouler quelques minutes avant qu'elle ne devienne active et puisse être interrogée. Vous pouvez consulter les métriques de la vue pour suivre sa progression.

Console

  1. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

    Ouvrir la liste des instances

  2. Sélectionnez une instance.

  3. Dans le volet de navigation, cliquez sur Bigtable Studio.

  4. Ouvrez un nouvel onglet en cliquant sur , puis sélectionnez Éditeur.

    1. Lorsque l'éditeur de requête s'affiche, rédigez votre requête. Si la requête est une requête SQL valide, le message Valide s'affiche.

    2. (Facultatif) Pour mettre en forme votre instruction au format SQL, cliquez sur Mettre en forme.

    3. Cliquez sur Exécuter. Les résultats de votre requête s'affichent dans la table Résultats.

    4. Lorsque vous êtes satisfait de la requête, cliquez sur Enregistrer, puis sélectionnez Vue matérialisée.

    Pour en savoir plus sur l'utilisation de l'éditeur de requêtes, consultez Gérer vos données à l'aide de Bigtable Studio.

gcloud

Pour créer une vue matérialisée continue, utilisez la commande gcloud beta bigtable materialized-views create :

    gcloud beta bigtable materialized-views create VIEW \
            --instance=INSTANCE --query=QUERY

Remplacez les éléments suivants :

  • VIEW : identifiant unique de la vue matérialisée continue. Vous devez utiliser cet ID comme ID de table lorsque vous interrogez la vue matérialisée continue.
  • INSTANCE : identifiant de l'instance dans laquelle créer la vue matérialisée continue. Doit être la même instance que la table source.
  • QUERY : instruction SQL valide qui définit la vue matérialisée continue.

Facultatif : pour activer la protection contre la suppression de la vue matérialisée continue, ajoutez la commande suivante :

--deletion-protection=DELETION_PROTECTION

Remplacez DELETION_PROTECTION par true ou false.

Mettre à jour une vue matérialisée continue

Vous pouvez mettre à jour la protection contre la suppression pour une vue matérialisée continue. Vous ne pouvez pas mettre à jour la requête SQL qui définit une vue matérialisée continue. Si vous devez modifier la requête, vous devez supprimer la vue matérialisée continue, puis en créer une qui inclut vos modifications.

Console

Vous ne pouvez pas mettre à jour une vue matérialisée continue dans la console. Utilisez plutôt gcloud CLI.

gcloud

Pour activer ou désactiver la protection contre la suppression pour une vue matérialisée continue, utilisez la commande gcloud beta bigtable materialized-views update command.

gcloud beta bigtable materialized-views update VIEW \
        -–instance=INSTANCE --deletion-protection=DELETION_PROTECTION

Remplacez les éléments suivants :

  • VIEW : identifiant unique de la vue matérialisée continue que vous souhaitez mettre à jour
  • INSTANCE : identifiant de l'instance contenant la vue matérialisée continue
  • DELETION_PROTECTION : true ou false

Supprimer une vue matérialisée continue

Vous pouvez supprimer une vue matérialisée continue pour laquelle la protection contre la suppression n'est pas activée. Cette opération est irréversible.

Console

  1. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

    Ouvrir la liste des instances

  2. Sélectionnez une instance dans la liste.

  3. Dans le volet de navigation, cliquez sur Bigtable Studio.

  4. Développez Vues matérialisées.

  5. À côté de la vue que vous souhaitez supprimer, cliquez sur le menu d'actions more_vert, puis sur Supprimer.

gcloud

Pour supprimer une vue matérialisée continue, utilisez la commande gcloud beta bigtable materialized-views delete :

gcloud beta bigtable materialized-views delete VIEW \
      --instance=INSTANCE

Remplacez les éléments suivants :

  • VIEW : identifiant unique de la vue matérialisée continue que vous souhaitez supprimer
  • INSTANCE : identifiant de l'instance contenant la vue matérialisée continue

Obtenir la liste des vues matérialisées continues

Vous pouvez afficher la liste des vues matérialisées continues pour une instance.

Console

  1. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

    Ouvrir la liste des instances

  2. Sélectionnez une instance dans la liste.

  3. Dans le volet de navigation, cliquez sur Bigtable Studio. Une liste des vues matérialisées continues s'affiche.

  4. Facultatif : Les 10 premières vues de l'instance sont listées. Pour en afficher 10 de plus, cliquez sur Afficher plus.

gcloud

Pour lister toutes les vues matérialisées continues d'une instance, utilisez la commande gcloud bigtable materialized-views list.

gcloud bigtable materialized-views list --instance=INSTANCE

Remplacez INSTANCE par l'ID de l'instance.

Étapes suivantes