Gérer les instances répliquées de vues matérialisées

Ce document explique comment gérer les instances répliquées de vues matérialisées dans BigQuery.

La gestion BigQuery des instances répliquées de vues matérialisées comprend les opérations suivantes :

Pour en savoir plus sur les instances répliquées de vues matérialisées, consultez les pages suivantes :

Avant de commencer

Attribuez aux utilisateurs des rôles IAM (Identity and Access Management) incluant les autorisations nécessaires pour effectuer l'ensemble des tâches du présent document. Les autorisations requises pour effectuer une tâche (le cas échéant) sont répertoriées dans la section "Autorisations requises" de la tâche.

Répertorier les instances répliquées de vues matérialisées

Vous pouvez répertorier les instances répliquées de vues matérialisées via la console Google Cloud.

Autorisations requises

Pour répertorier les instances répliquées de vues matérialisées dans un ensemble de données, vous devez disposer de l'autorisation IAM bigquery.tables.list.

Chacun des rôles IAM prédéfinis suivants inclut les autorisations dont vous avez besoin pour répertorier les instances répliquées de vues matérialisées d'un ensemble de données :

  • roles/bigquery.user
  • roles/bigquery.metadataViewer
  • roles/bigquery.dataViewer
  • roles/bigquery.dataOwner
  • roles/bigquery.dataEditor
  • roles/bigquery.admin

Pour en savoir plus sur les rôles et les autorisations IAM dans IAM, consultez la page Rôles prédéfinis et autorisations.

Pour répertorier les instances répliquées de vues matérialisées dans un ensemble de données, procédez comme suit :

  1. Dans le panneau Explorateur, développez votre projet et sélectionnez un ensemble de données.

  2. Faites défiler la liste pour voir les tables de l'ensemble de données. Les tables, les vues et les vues matérialisées sont identifiées par des icônes différentes. Les instances répliquées de vues matérialisées possèdent la même icône que les vues matérialisées.

    Icône table et vue

Obtenir des informations sur les instances répliquées de vues matérialisées

Vous pouvez obtenir des informations sur une instance répliquée de vue matérialisée à l'aide de SQL, de l'outil de ligne de commande bq ou de l'API BigQuery.

Autorisations requises

Pour interroger des informations sur une instance répliquée de vue matérialisée, vous devez disposer des autorisations IAM (Identity and Access Management) suivantes :

  • bigquery.tables.get
  • bigquery.tables.list
  • bigquery.routines.get
  • bigquery.routines.list

Chacun des rôles IAM prédéfinis suivants inclut les autorisations ci-dessus :

  • roles/bigquery.metadataViewer
  • roles/bigquery.dataViewer
  • roles/bigquery.admin

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Pour obtenir des informations sur une instance répliquée de vue matérialisée, y compris la vue matérialisée source :

SQL

Pour obtenir des informations sur les instances répliquées de vues matérialisées, interrogez la vue INFORMATION_SCHEMA.TABLES :

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

    Accéder à BigQuery

  2. Dans l'éditeur de requête, saisissez l'instruction suivante :

    SELECT * FROM PROJECT_ID.DATASET_ID.INFORMATION_SCHEMA.TABLES
WHERE table_type = 'MATERIALIZED VIEW';

    Remplacez les éléments suivants :

    • PROJECT_ID : nom du projet contenant les instances répliquées de vues matérialisées
    • DATASET_ID : nom de l'ensemble de données contenant les instances répliquées de vues matérialisées

  3. Cliquez sur Exécuter.

Pour en savoir plus sur l'exécution des requêtes, consultez Exécuter une requête interactive.

bq

Exécutez la commande bq show :

bq show --project=project_id --format=prettyjson dataset.materialized_view_replica

Remplacez les éléments suivants :

  • project_id : ID du projet. Il vous suffit d'inclure cette option pour obtenir des informations sur une instance répliquée de vue matérialisée dans un projet différent de celui par défaut.
  • dataset : nom de l'ensemble de données contenant l'instance répliquée de la vue matérialisée.
  • materialized_view_replica : nom de l'instance répliquée de la vue matérialisée pour laquelle vous souhaitez obtenir des informations.

Exemple :

Saisissez la commande suivante pour afficher des informations sur l'instance répliquée de la vue matérialisée my_mv_replica dans l'ensemble de données report_views du projet myproject.

bq show --project=myproject --format=prettyjson report_views.my_mv_replica

API

Pour obtenir des informations sur les instances répliquées de vues matérialisées à l'aide de l'API, appelez la méthode tables.get.

Supprimer des instances répliquées de vues matérialisées

Vous pouvez supprimer une instance répliquée de vue matérialisée via la console Google Cloud.

Autorisations requises

Pour supprimer des instances répliquées de vues matérialisées, vous devez disposer de l'autorisation IAM bigquery.tables.delete.

Chacun des rôles IAM prédéfinis suivants inclut les autorisations dont vous avez besoin pour supprimer une instance répliquée de vue matérialisée :

  • bigquery.dataEditor
  • bigquery.dataOwner
  • bigquery.admin

Pour en savoir plus sur BigQuery Identity and Access Management (IAM), consultez la page Rôles et autorisations prédéfinis.

  1. Dans le volet Explorateur, développez votre projet et sélectionnez l'instance répliquée de la vue matérialisée.

  2. Développez l'option Actions, puis cliquez sur Supprimer.

  3. Dans la boîte de dialogue Supprimer la vue matérialisée ?, saisissez delete dans le champ, puis cliquez sur Supprimer.