マテリアライズド ビューのレプリカを管理する

このドキュメントでは、BigQuery でマテリアライズド ビュー レプリカを管理する方法について説明します。

BigQuery でのマテリアライズド ビューレプリカの管理では、次の作業を行います。

マテリアライズド ビューのレプリカの詳細については、以下をご覧ください。

始める前に

このドキュメントの各タスクを実行するために必要な権限をユーザーに与える Identity and Access Management（IAM）のロールを付与します。タスクの実行に必要な権限（存在する場合）は、タスクの「必要な権限」セクションに記載されています。

マテリアライズド ビューのレプリカを一覧表示する

マテリアライズド ビューのレプリカは、Google Cloud コンソールで一覧表示できます。

必要な権限

データセット内のマテリアライズド ビューのレプリカの一覧を取得するには、bigquery.tables.list IAM 権限が必要です。

次の IAM 事前定義ロールには、データセット内のマテリアライズド ビューを一覧表示するために必要な権限が含まれています。

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

IAM のロールと権限については、事前定義ロールと権限をご覧ください。

データセット内のマテリアライズド ビューのレプリカを一覧表示するには:

  1. [エクスプローラ] パネルでプロジェクトを開いて、データセットを選択します。

  2. リストをスクロールして、データセット内のテーブルを表示します。テーブル、ビュー、マテリアライズド ビューは別々のアイコンで表示されます。マテリアライズド ビューのレプリカには、マテリアライズド ビューと同じアイコンが付いています。

    テーブルとビューのアイコン

マテリアライズド ビューのレプリカに関する情報を取得する

マテリアライズド ビューのレプリカに関する情報を取得するには、SQL、bq コマンドライン ツール、または BigQuery API を使用します。

必要な権限

マテリアライズド ビューのレプリカに関する情報をクエリするには、次の Identity and Access Management（IAM）権限が必要です。

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

次の各 IAM 事前定義ロールには上記の権限が含まれています。

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

BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。

マテリアライズド ビューのレプリカに関する情報（ソースのマテリアライズド ビューを含む）を取得するには:

SQL

マテリアライズド ビューのレプリカに関する情報を取得するには、INFORMATION_SCHEMA.TABLES ビューにクエリを実行します。

  1. Google Cloud コンソールで [BigQuery] ページに移動します。

    [BigQuery] に移動

  2. クエリエディタで次のステートメントを入力します。

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

    次のように置き換えます。

    • PROJECT_ID: マテリアライズド ビューのレプリカを含むプロジェクトの名前
    • DATASET_ID: マテリアライズド ビューのレプリカを含むデータセットの名前

  3. [実行] をクリックします。

クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。

bq

bq show コマンドを実行します。

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

次のように置き換えます。

  • project_id: プロジェクト ID。このフラグは、デフォルト プロジェクトと異なるプロジェクト内のマテリアライズド ビューのレプリカに関する情報を取得する場合にのみ指定する必要があります。
  • dataset: マテリアライズド ビューのレプリカを含むデータセットの名前。
  • materialized_view_replica: 情報を取得するマテリアライズド ビューのレプリカの名前。

例:

次のコマンドを入力して、myproject プロジェクトの report_views データセットにあるマテリアライズド ビューのレプリカ my_mv_replica に関する情報を表示します。

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

API

API でマテリアライズド ビューのレプリカ情報を取得するには、tables.get メソッドを呼び出します。

マテリアライズド ビューのレプリカを削除する

マテリアライズド ビューのレプリカは、Google Cloud コンソールから削除できます。

必要な権限

マテリアライズド ビューのレプリカを削除するには、bigquery.tables.delete IAM 権限が必要です。

次の IAM 各事前定義ロールには、マテリアライズド ビューの削除に必要な権限が含まれています。

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

BigQuery Identity and Access Management（IAM）の詳細については、事前定義ロールと権限をご覧ください。

  1. [エクスプローラ] ペインでプロジェクトを開き、マテリアライズド ビューのレプリカを選択します。

  2. アクション オプションを開いて、[削除] をクリックします。

  3. [Delete materialized view?] ダイアログで、フィールドに「delete」と入力し、[削除] をクリックします。