保存済みクエリを管理する

このドキュメントでは、保存したクエリと従来の保存したクエリを管理する方法について説明します。

保存済みクエリ

保存済みクエリを管理する方法については、以降のセクションをご覧ください。保存済みクエリは、Dataform によって強化された BigQuery Studio コードアセットです。

必要な権限

保存したクエリを管理するには、次の Identity and Access Management（IAM）ロールが必要です。

• BigQuery ジョブユーザー（roles/bigquery.jobUser）
• BigQuery 読み取りセッション ユーザー（roles/bigquery.readSessionUser）
• コードオーナー（roles/dataform.codeOwner）

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

保存したクエリへのアクセス権を付与する

保存済みクエリへのアクセス権を他のユーザーに付与するには、それらのユーザーを適切な IAM ロールに追加します。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。アクセスを許可する保存済みクエリを見つけます。

3. 保存済みクエリの横にある more_vert [アクションを表示] をクリックし、[共有] > [権限を管理] をクリックします。

4. [権限を管理] ペインで、[ユーザー / グループの追加] をクリックします。

5. [新しいプリンシパル] フィールドに、プリンシパルを入力します。

6. [ロール] リストで、次のいずれかのロールを選択します。

   • コードオーナー: 保存済みクエリに対して、削除や共有などあらゆる操作を行うことができます。
   • コードエディタ: クエリを編集できます。
   • コード閲覧者: クエリを表示できます。

7. 省略可: ロールと詳細な共有設定の完全なリストを表示するには、[詳細な共有] をクリックします。

8. [保存] をクリックします。

9. 保存したクエリの情報に戻るには、[閉じる] をクリックします。

保存したクエリを共有する

保存したクエリを他のユーザーと共有するには、保存したクエリへのリンクを生成して共有します。共有されている保存したクエリがユーザーに対して表示されるようにするには、まず、保存したクエリへのアクセス権を付与する必要があります。

共有クエリを実行するには、クエリがアクセスするデータへのアクセス権が必要です。詳細については、データセットへのアクセス権を付与するをご覧ください。

保存済みクエリを共有する予定の場合は、その目的を説明するコメントをクエリに含めることを検討してください。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。共有する保存済みクエリを見つけます。

3. クエリの横にある more_vert [アクションを表示] をクリックし、[共有] > [リンクをコピー] をクリックします。

4. リンクを他のユーザーと共有します。

すべての保存済みクエリを表示する

プロジェクトに保存されているすべてのクエリのリストを表示するには、次の操作を行います。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、[クエリ] の横にある more_vert（アクションを表示）をクリックし、次のいずれかを行います。

• 現在のタブでリストを開くには、[すべて表示] をクリックします。
• リストを新しいタブで開くには、[すべてを表示] > [新しいタブ] をクリックします。
• 分割タブでリストを開くには、[すべてを表示] > [タブを分割] をクリックします。

保存済みクエリのメタデータを表示する

保存済みクエリのメタデータを表示する手順は次のとおりです。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。メタデータを表示する保存済みクエリの名前をクリックします。

3. [概要] ペインで、使用されているリージョンや最終更新日など、保存したクエリに関する情報を確認します。

保存したクエリ バージョンを操作する

以降のセクションでは、保存したクエリのバージョンを表示、比較、復元する方法について説明します。

保存したクエリのバージョンを表示する

保存済みクエリのバージョンを表示する手順は次のとおりです。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。アクティビティを表示する保存済みクエリの名前をクリックします。

3. [アクティビティ] タブをクリックすると、保存したクエリのバージョンの一覧が日付の降順で表示されます。

保存したクエリのバージョンを比較する

保存済みクエリのバージョンを比較する手順は次のとおりです。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。バージョン情報を比較する保存済みクエリの名前をクリックします。

3. [アクティビティ] タブで、保存したクエリ バージョンの横にある more_vert [アクションを表示] をクリックし、[比較] をクリックします。比較ペインが開き、選択した保存したクエリのバージョンと現在の保存したクエリのバージョンを比較します。

4. 省略可: 個別のペインではなくインラインでバージョンを比較するには、[比較]、[インライン] の順にクリックします。

保存したクエリ バージョンを復元する

保存したクエリ バージョンを復元するには、次のいずれかのオプションを使用します。比較ペインから復元すると、復元するかどうかを選択する前に、保存したクエリの以前のバージョンを現在のバージョンと比較できます。

保存済みクエリをダウンロードする

保存済みクエリをダウンロードするには、次の操作を行います。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。保存済みクエリの名前をクリックして開きます。

3. [ダウンロード] をクリックします。

保存済みクエリを削除

保存済みクエリを削除するには、次の操作を行います。

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。削除する保存済みクエリを見つけます。

3. 保存したクエリの横にある [more_vert アクションを表示] をクリックし、[削除] をクリックします。

4. 削除を確定するには、ダイアログで「delete」と入力します。

5. [削除] をクリックします。

従来の保存済みクエリ

従来の保存済みクエリの管理方法については、以降のセクションをご覧ください。

従来の保存済みクエリを共有する

共有できる従来の保存したクエリは、公開設定がプロジェクトまたは一般公開に設定されているクエリです。プロジェクトの公開設定を指定すると、必要な権限を持つプリンシパルがクエリを表示、更新、削除できます。一般公開の公開設定では、クエリリンクを知っているすべての人がクエリを表示できますが、更新や削除はできません。

従来の保存したクエリを他のユーザーと共有するには、このクエリへのリンクを生成して共有します。

従来の共有クエリを実行するには、クエリがアクセスするデータへのアクセス権が必要です。詳細については、データセットへのアクセス権を付与するをご覧ください。

従来の保存済みクエリを共有する場合は、その目的を説明するコメントをクエリに含めることを検討してください。

1. [エクスプローラ] ペインで、プロジェクトと [（従来）クエリ] フォルダを開き、共有する従来の保存済みクエリを見つけます。
2. クエリの横にある more_vert（アクションを表示）をクリックし、[リンクを取得] をクリックします。
3. クエリへのアクセスを許可するユーザーとリンクを共有します。

従来の保存済みクエリを移行する

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [（従来）クエリ] フォルダを開き、必要に応じて [プロジェクト クエリ] フォルダを開きます。

3. 従来の保存済みクエリの名前をクリックして開きます。

4. [クエリ（従来）を保存] > [クエリに名前を付けて保存...] をクリックします。

5. [クエリを保存] ダイアログで、クエリの名前を入力してロケーションを選択します。

6. [保存] をクリックします。

従来の保存済みクエリを削除する

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

   [BigQuery] に移動

2. [エクスプローラ] ペインで、プロジェクトと [（従来）クエリ] フォルダを開き、必要に応じて [プロジェクト クエリ] フォルダを開きます。

3. 削除する従来の保存済みクエリを見つけます。

4. クエリの横にある [ more_vert アクションを表示] をクリックし、[削除] をクリックします。

5. 削除を確定するには、ダイアログで「delete」と入力します。

6. [削除] をクリックします。