保存済みクエリを作成する

クエリエディタで SQL を記述すると、クエリを保存して他のユーザーと共有できます。保存済みクエリは、Dataform によって強化された BigQuery Studio コードアセットです。

保存したクエリの削除と保存したクエリの履歴の管理の詳細については、保存済みクエリを管理するをご覧ください。

必要な権限

保存したクエリを作成、編集、表示するための適切な権限を設定します。

Dataform 管理者（roles/dataform.admin）ロールを持つすべてのユーザーは、プロジェクトで作成されたすべての保存クエリに対するオーナー アクセス権を持ちます。

BigQuery Identity and Access Management（IAM）の詳細については、IAM によるアクセス制御をご覧ください。

保存したクエリを作成する権限

保存したクエリを作成して実行するには、次の IAM 権限が必要です。

• dataform.locations.get
• dataform.locations.list
• dataform.repositories.list

• dataform.repositories.create

  注: dataform.repositories.create 権限を持つユーザーは、デフォルトの Dataform サービス アカウントと、そのサービス アカウントに付与されたすべての権限を使用してコードを実行できます。詳細については、Dataform 権限のセキュリティに関する考慮事項をご覧ください。

これらの権限は、次の IAM ロールから取得できます。

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

• コード作成者（roles/dataform.codeCreator）

  注: プロジェクトでコード作成者ロールが割り当てられているユーザーは、Dataform API または Dataform コマンドライン インターフェース（CLI）を使用して、そのプロジェクトのコードアセットの名前を一覧取得できます。BigQuery Studio を使用する管理者以外のユーザーは、自身が作成したコードアセットまたは自身と共有されているコードアセットのみを表示できます。

保存したクエリを編集する権限

保存したクエリを編集して実行するには、次の IAM ロールが必要です。

• BigQuery ジョブユーザー（roles/bigquery.jobUser）
• BigQuery 読み取りセッション ユーザー（roles/bigquery.readSessionUser）
• コードエディタ（roles/dataform.codeEditor）

保存したクエリを表示する権限

保存したクエリを表示して実行するには、次の IAM ロールが必要です。

• BigQuery ジョブユーザー（roles/bigquery.jobUser）
• BigQuery 読み取りセッション ユーザー（roles/bigquery.readSessionUser）
• コード閲覧者（roles/dataform.codeViewer）

コードアセットにデフォルトのリージョンを設定する

コードアセットを初めて作成する場合は、コードアセットのデフォルト リージョンを設定する必要があります。コードアセットのリージョンを作成後に変更することはできません。

注: 保存済みクエリを作成し、コードアセットに使用しているリージョンとは異なるデフォルト リージョンを選択する（たとえば us-west1 使用している場合に us-central1を選択する）と、そのクエリと、その後に作成したすべてのコードアセットでは、デフォルトで新しいリージョンが使用されます。既存のコードアセットでは、作成時に割り当てられたリージョンが引き続き使用されます。

BigQuery Studio のすべてのコードアセットは同じデフォルト リージョンを使用します。コードアセットのデフォルト リージョンを設定する手順は次のとおりです。

1. [BigQuery] ページに移動します。

   [BigQuery] に移動

2. [エクスプローラ] ペインで、コードアセットを有効にしたプロジェクトを見つけます。

3. プロジェクトの横にある （アクションを表示）をクリックし、[デフォルトのコード リージョンを変更] をクリックします。

4. [リージョン] で、コードアセットに使用するリージョンを選択します。

5. [選択] をクリックします。

サポートされているリージョンの一覧については、BigQuery Studio のロケーションをご覧ください。

保存したクエリを作成する

保存済みクエリを作成する手順は次のとおりです。

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

   [BigQuery] に移動

2. [ SQL クエリ] をクリックします。

3. クエリエディタで、有効な SQL クエリを入力します。たとえば、一般公開データセットに対してクエリを実行できます。

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;

   または、[リファレンス] パネルを使用して新しいクエリを作成することもできます。

4. （保存）> [クエリを保存] をクリックするか、Ctrl+S キー（macOS の場合は Command+S キー）を押します。

5. [クエリを保存] ダイアログで、保存済みクエリの名前を入力します。

6. 省略可: この保存済みクエリと今後の他のすべてのコードアセットで使用されるリージョンを変更するには、[リージョン] で新しいリージョンを選択します。

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

   保存済みクエリの最初のバージョンが作成されます。

8. 省略可: クエリを保存した後は、次のツールバーを使用して、クエリの詳細やバージョン履歴の表示、新しいコメントの追加、既存のコメントへの返信、既存のコメントへのリンクの取得を行うことができます。

   

   [詳細]、[変更履歴]、[コメント] のツールバー機能はプレビュー版です。これらの機能に関するフィードバックやサポートをリクエストする場合は、[e-mail] までメールをお送りください。

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

保存済みクエリをユーザーと共有するには、まずそのユーザーに保存済みクエリへのアクセス権を付与し、適切な IAM ロールに追加します。次に、保存済みクエリへのリンクを生成し、そのリンクをユーザーと共有します。

クエリを共有したユーザーには、クエリの最新バージョンのみが表示されます。明示的に保存していない自動保存された変更は、共有クエリには表示されません。

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

   BigQuery に移動

2. 左側のペインで、 [エクスプローラ] をクリックします。

   

   左側のペインが表示されていない場合は、 左側のペインを開くをクリックしてペインを開きます。

3. [エクスプローラ] ペインで、プロジェクトを開き、[クエリ] をクリックします。

4. アクセス権を付与する保存済みクエリを見つけてクリックします。検索機能またはフィルタを使用して、クエリを見つけることができます。

5. [共有]、[権限を管理] の順にクリックします。

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

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

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

   • コードオーナー: 保存済みクエリに対して、削除や共有などあらゆる操作を行うことができます。
   • コードエディタ: クエリを編集できます。
   • コード閲覧者: クエリを表示できます。
   注: プリンシパルには、保存済みクエリを実行するための BigQuery ユーザー（roles/bigquery.user）ロールも必要です。

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

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

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

12. 保存済みクエリへのリンクを生成するには、 [共有]、[リンクを取得] の順にクリックします。

    リンクがクリップボードにコピーされます。

保存したクエリ バージョンを新しいクエリとして開く

既存の保存したクエリの任意のバージョンを新しいクエリとして開く手順は、次のとおりです。

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

   BigQuery に移動

2. 左側のペインで、 [エクスプローラ] をクリックします。

   

   左側のペインが表示されていない場合は、 左側のペインを開くをクリックしてペインを開きます。

3. [エクスプローラ] ペインで、プロジェクトを開き、[クエリ] をクリックします。

4. 保存したクエリを選択します。検索機能またはフィルタを使用して、クエリを見つけることができます。

5. [変更履歴] をクリックします。

6. 保存したクエリ バージョンの横にある （アクションを表示）をクリックし、[新規クエリとして開く] をクリックします。

保存したクエリを更新する

保存したクエリのテキストに加えた変更は、入力が停止してから 2 秒後に自動的に保存され、[変更履歴] に [変更内容] として表示されます。自動保存された変更は、クエリの新しいバージョンではありません。自動保存された変更は、クエリを開くたびに表示されますが、クエリの新しいバージョンとして明示的に保存しない限り、他のユーザーには表示されません。自動保存されたクエリはプレビュー版です。

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

   BigQuery に移動

2. 左側のペインで、 [エクスプローラ] をクリックします。

   

3. [エクスプローラ] ペインで、プロジェクトを開き、[クエリ] をクリックします。

4. 保存したクエリを選択します。検索機能またはフィルタを使用して、クエリを見つけることができます。

5. クエリを変更します。

6. 変更したクエリを保存するには、 [クエリを保存] > [クエリを保存] をクリックするか、Ctrl+S（macOS の場合は Command+S）を押します。

   クエリの新しいバージョンが作成されます。

保存したクエリをアップロードする

ローカル SQL クエリをアップロードして、BigQuery Studio で保存したクエリとして使用できます。アップロードされた保存済みクエリは、 Google Cloud コンソールの BigQuery ページにも表示されます。

保存したクエリをアップロードするには、次の操作を行います。

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

   BigQuery に移動

2. 左側のペインで、 [エクスプローラ] をクリックします。

   

3. [エクスプローラ] ペインでプロジェクトを開き、次のいずれかを行います。

   • [クエリ] の横にある （アクションを表示）> [SQL クエリのアップロード] をクリックします。
   • Google Cloud プロジェクト名の横にある （アクションを表示）> [プロジェクトにアップロードする] > [SQL クエリ] をクリックします。

4. [SQL のアップロード] ダイアログの [SQL] フィールドで、[参照] をクリックして、アップロードするクエリを選択します。

5. 省略可: [SQL 名] フィールドで、クエリの名前を編集します。

6. [リージョン] フィールドで、保存したクエリをアップロードするリージョンを選択します。

7. [アップロード] をクリックします。

保存したクエリには、[エクスプローラ] ペインからアクセスできます。

従来の保存したクエリ

非推奨: 今後、従来の保存済みクエリは BigQuery Studio で利用できる保存済みクエリに完全に置き換えられます。サポート終了期限は現在審査中です。詳細については、従来の保存済みクエリのサポート終了をご覧ください。保存済みクエリの移行方法については、従来の保存済みクエリを移行するをご覧ください。

以降のセクションでは、従来の保存したクエリを作成、更新する方法について説明します。従来の保存したクエリの共有、移行、削除の詳細については、従来の保存したクエリをご覧ください。

注: BigQuery Studio を有効にしていない場合、従来の保存済みクエリは、[（従来）クエリ] フォルダではなく、[従来のエクスプローラ] ペインの [保存したクエリ（NUMBER）] フォルダに表示されます。

従来の保存したクエリに必要な権限

保存したクエリを作成、表示、更新、削除するには、次の IAM 権限が必要です。

• 非公開の従来の保存したクエリ:
  • 非公開の従来の保存したクエリを作成するために特別な権限は必要ありません。非公開クエリはどのプロジェクトにも保存できますが、このクエリを表示、更新、削除できるのは保存したユーザーに限られます。
• プロジェクト レベルの従来の保存したクエリ:
  • プロジェクトレベルの保存したクエリを作成するには、bigquery.savedqueries.create 権限が必要です。定義済みの bigquery.admin 役割には、bigquery.savedqueries.create 権限が含まれています。
  • プロジェクトレベルの従来の保存したクエリを表示するには、bigquery.savedqueries.get と bigquery.savedqueries.list 権限が必要です。定義済みの bigquery.admin および bigquery.user 役割には、bigquery.savedqueries.get 権限と bigquery.savedqueries.list 権限が含まれています。
  • プロジェクトレベルの従来の保存したクエリを更新するには、bigquery.savedqueries.update 権限が必要です。定義済みの bigquery.admin 役割には、bigquery.savedqueries.update 権限が含まれています。
  • プロジェクトレベルの従来の保存したクエリを削除するには、bigquery.savedqueries.delete 権限が必要です。定義済みの bigquery.admin 役割には、bigquery.savedqueries.delete 権限が含まれています。
• 一般公開の従来の保存したクエリ:
  • 一般公開の従来の保存したクエリを作成するために特別な権限は必要ありません。一般公開の従来の保存したクエリは任意のプロジェクトに保存できますが、このクエリを更新または削除できるのは保存したユーザーのみです。リンクを知っていれば誰でも、一般公開の従来の保存したクエリを閲覧できます。

注: プロジェクト レベルで dataform.repository.list 権限が付与されているユーザーは、プロジェクトで作成されたすべての保存したクエリを表示できます。

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

従来の保存したクエリを作成する

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

   [BigQuery] に移動

2. [ SQL クエリ] をクリックします。

3. クエリエディタで、有効な SQL クエリを入力します。たとえば、一般公開データセットに対してクエリを実行できます。

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;

4. [クエリ（従来）を保存] > [クエリ（従来）を保存] をクリックします。

5. [クエリを保存] ダイアログで、クエリの名前を入力し、[公開設定] を次のいずれかのオプションに設定します。

   • 個人用（本人のみが編集可能）: 非公開の従来の共有クエリの場合。
   • プロジェクト（適切な権限を持つプリンシパルが編集可能）: プロジェクト レベルの従来の保存したクエリの場合。
   • 一般公開: 一般公開の従来の保存したクエリの場合。

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

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

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

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

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

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

1. 左側のペインで、カテゴリ クラシック エクスプローラをクリックします。

   

   左側のペインが表示されていない場合は、 左側のペインを開くをクリックしてペインを開きます。

2. [従来のエクスプローラ] ペインで、プロジェクトを開き、[（従来）クエリ] をクリックして、共有する従来の保存済みクエリを見つけます。

3. クエリの横にある （アクションを表示）をクリックし、[リンクを取得] をクリックします。

4. クエリへのアクセスを許可するユーザーとリンクを共有します。

従来の保存したクエリを更新する

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

   BigQuery に移動

2. 左側のペインで、カテゴリ クラシック エクスプローラをクリックします。

   

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

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

5. クエリを変更します。

6. 変更したクエリを保存するには、 [クエリ（従来）を保存] > [クエリ（従来）を保存] をクリックします。

次のステップ

• 保存したクエリを管理する方法を確認する。