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ête Bigtable Studio dans la Google Cloud console ou des bibliothèques clientes Bigtable pour Java et Go.

Avant de commencer

Procédez comme suit si vous prévoyez d'utiliser la gcloud CLI.

  1. Installez la Google Cloud CLI.

  2. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  3. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    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
  • Mettre à 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 : Nous vous recommandons d'activer l' autoscaling pour les clusters de votre instance afin de vous assurer 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 stockage supplémentaire.
  • Identifiez une table Bigtable pour laquelle vous disposez d'une autorisation de lecture à utiliser comme 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 queries.

Une fois que vous avez créé une vue matérialisée continue, quelques minutes peuvent être nécessaires pour qu'elle devienne active et puisse être interrogée. Vous pouvez consulter les métriques de la vue pour surveiller sa progression.

Console

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

    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 et en sélectionnant Éditeur.

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

    2. Facultatif : Pour mettre en forme votre instruction dans le style SQL, cliquez sur Format.

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

    4. Lorsque la requête vous convient, cliquez sur la flèche d'expansion Enregistrer sous , puis sélectionnez Enregistrer en tant que vue matérialisée.

  5. Dans la boîte de dialogue Enregistrer votre vue matérialisée, saisissez un nom pour la vue, puis cliquez sur Enregistrer.

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

gcloud

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

    gcloud 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 utilisez cet ID comme ID de table lorsque 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 pour 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 la gcloud CLI.

gcloud

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

gcloud 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 Google Cloud console.

    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 more_vert, puis sur Supprimer.

gcloud

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

gcloud 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 Google Cloud console.

    Ouvrir la liste des instances

  2. Sélectionnez une instance dans la liste.

  3. Dans le volet de navigation, cliquez sur Bigtable Studio. La 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 Tout afficher.

gcloud

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

gcloud bigtable materialized-views list --instance=INSTANCE

Remplacez INSTANCE par l'ID de l'instance.

Étape suivante